Name

decedi_manage − DEC/EDI Server Management Functions
 
 

Description

 
The decedi_manage command is a utility that provides access to common DEC/EDI Server functions. The functions provided are designed to be used directly on the server. 

 
Many of the functions are provided to allow the user to build their own communications scheduling system. decedi_manage commands can be scheduled and run by the UNIX cron daemon, or by other products like POLYCENTER Scheduler. For more information on using the cron daemon, see the man pages for cron and crontab. A sample documented DEC/EDI crontab file can be found in /var/adm/decedi/crontab. 

 
Processing errors encountered by the utility are indicated by the return of suitable exit status codes, and are also recorded in the error log.
 
 

FORMAT

decedi_manage -sc conn_id [job_id]
 
decedi_manage -ec conn_id
 
decedi_manage -dc conn_id
 
decedi_manage -rc conn_id
 
decedi_manage -tc enabled conn_id
 
decedi_manage -tc error conn_id
 
decedi_manage -tc locked conn_id
 
decedi_manage -eg gateway_id
 
decedi_manage -dg gateway_id
 
decedi_manage -sg gateway_id
 
decedi_manage -kg gateway_id
 
decedi_manage -tg enabled gateway_id
 
decedi_manage -tg running gateway_id
 
decedi_manage -v
 
decedi_manage -h
 
 
 
 

Flags

-scSends a Start Connection request to the communications controller for the specified Connection Id. An optional Job Id can be specified for Job based connections, such as those used by the Import/Export and 3780 gateways. 
 
 
An exit status of 0 indicates that the request was successfully sent.
 

-ecEnables the specified Connection Id to allow communications. 
 
 
An exit status of 0 indicates successfull completion.
 

-dcDisables the specified Connection Id to disallow communications. 
 
 
An exit status of 0 indicates successfull completion.
 

-rcResets the current error count for the specified Connection Id to zero. 
 
 
An exit status of 0 indicates successfull completion.
 

-tc enabledTests the current status of the specified Connection Id. 
 
 
Returns 0 to indicate that the connection is enabled. Returns 1 to indicate that the connection is disabled.
 

-tc errorTests the current error count of the specified Connection Id. 
 
 
Returns a positive integer to indicate the current error count. Returns -1 to indicate an error.
 

-tc lockedTests the current status of the specified Connection Id. 
 
 
Returns 0 to indicate that the connection is currently idle. Returns 1 to indicate that the connection is currently busy.
 

-egEnables the specified gateway to allow communications. This function modifies the initial startup status of the gateway to enabled, and modifies the current status of the running gateway to enabled. 
 
 
An exit status of 0 indicates successfully completion.
 

-dgDisables the specified gateway to disallow communications. This function modifies the initial startup status of the gateway to disabled, and modifies the current status of the running gateway to disabled. 
 
 
An exit status of 0 indicates successfully completion.
 

-sgStarts the specified gateway process. 
 
 
An exit status of 0 indicates that the process has been started. This does not indicate that a gateway has successfully initialized.
 

-kgSends a shutdown request to the specified gateway process. 
 
 
An exit status of 0 indicates that the request was successfully sent.
 

-tg enabledTests the current status of the specified gateway. 
 
 
Returns 0 to indicate that the gateway is enabled. Returns 1 to indicate that the gateway is disabled.
 

-tg runningTests the existence of the specified gateway process. 
 
 
Returns 0 to indicate that the gateway process is running. Returns 1 to indicate that the gateway process is not running.
 

-vDisplays the system version, and searches for any DEC/EDI images which are patches to the base version and displays them. 
 

-hDisplays the usage text. 
 
 
 
 

Examples

 # decedi_manage -sc conn1
# echo $status
0

 
This example will cause a connection to be started for Connection Id conn1. Note, that the optional Job Id is not specified.
 

 # decedi_manage -tc enabled oftp1
Connection is disabled
# echo $status
1

 
In this example, the Connection Id oftp1, is tested to see if it is enabled or disabled. Note the exit status of 1, to indicate that the connection is disabled.