Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ lu62_mcd(3) — SNA APPC LU6.2 3.2

Media Vault

Software Library

Restoration Projects

Artifacts Sought

lu62_mcd(3)  —  Subroutines

 
 

Name

lu62_mcd − Starts one or more processes and then monitors the status of these processes. 
 
 
 

FORMAT

/usr/sbin/lu62_mcd
-c integer
-e definition
-i command
-n string
-r integer
-syslog [g][a][c][e][w][n][i])
-m
 
 
 
 
 
 

Arguments

 

-c integer
 
 
Specifies the number of renamed core dumps that the LU62_MCD daemon should keep for the image following this flag. You can specify this value once for each -i flag.  Each new value applies only to the next -i flag that follows.  The value must be in the range 0 to 32767.  By default, the LU62_MCD daemon keeps up to 10 renamed core files for each image that it starts. 
 

-e definition
 
 
Specifies a quoted string containing the environment variable and its value. The definition argument must be in the format "variable = value".  The most common use for this flag is to set the SNALOG environment variables.  You can define up to 8 environment variables for each image (-i flag).  By default, the LU62_MCD daemon does not define any environment variables for processes that it starts. 
 

-i command
 
 
Specifies the quoted command line that the LU62_MCD daemon should use to invoke the requested image. You must specify this value once for each image that you wish the LU62_MCD daemon to invoke. There is no default for this flag. If you do not specify at least one instance of the -i flag, the LU62_MCD daemon exits without starting any processes. The argument you specify must have the following syntax:

 
"image [name] [flags]"

 
where

 
image specifies the name of the image file you wish the LU62_MCD daemon to run. Normally, you specify lu62_server for the LU6.2 server or lu62_amd for the LU6.2 Attach Manager daemon. If the image file is not in a path contained in your PATH environment variable (as the /usr/sbin path normally is), you must precede the image name with its full path. 

 
name optionally, specifies the server name you wish to assign this process. This name must agree with the server name portion of the server-name_CLI and server-name_SES service names you defined for the server. 
 
By default, the server assigns itself the server name LU62_SRV. Omit this parameter if you are starting the Attach Manager daemon. The Attach Manager daemon automatically assigns itself the name LU62_AMD.

 
flags optionally, specifies any flags you wish to pass the process. At this time, the valid flag are -syslog and -m.  By default, the server and the Attach Manager daemon default the syslog options to -syslog gacew.  For more information about the -syslog flag, see the -syslog flag in this table.  For more information about the -m flag, see the -m flag in this table. 
 

-m
 
 
Indicates that the LU62_MCD daemon should the multiple-line style when writing syslog messages. See the syslog appendix in the DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX Administrator’s Guide for information about the advantages and disadvantages of selecting this option. 
 

-n string
 
 
Specifies a string that the LU62_MCD daemon should use when it renames the core file of the image that follows this flag. The LU62_MCD daemon adds .core_<timestamp> to this string to form the file name. You can specify this value once for each -i flag. Each new value applies only to the next -i flag that follows. By default, the LU62_MCD daemon uses the server name or LU62_AMD for this string.
 

-r integer
 
 
Specifies the number of consecutive restarts that the LU62_MCD daemon should attempt for the image following this flag. You can specify this value once for each -i flag. Each new value applies only to the next -i flag that follows. The value must be in the range 0 to 32767. By default, the LU62_MCD daemon attempts up to 10 restarts for each image that it starts.
 

-syslog [g][a][c][e][w][n][i]
 
 
Specifies the enabled syslog error levels. Each syslog message is assigned to one of the following levels:

 
g - Emergency

 
a - Alert

 
c - Critical

 
e - Error

 
w - Warning

 
n - Notice

 
i - Informational

 
The first three levels (Emergency, Alert, and Critical) generally describe an internal software problem over which the user has limited, if any, control. The next two levels (Error and Warning) describe error conditions or possible error conditions which the user can correct. The last two levels (Notice and Informational) describe events that are considered normal server behavior.

 
You can only specify this flag once in a command line. The default, -syslog gacew, enables Emergency, Alert, Critical, Error, and Warning messages.
 
 

Description

 
If one of the processes that LU62_MCD is monitoring encounters an error condition from which it cannot recover, the process exits. When this happens, the DIGITAL UNIX systems creates a core file. The LU62_MCD daemon renames the core file to either a default name or a user-supplied name. Both names include a timestamp in the file name to prevent the loss of previous core files. After renaming the core file, the LU62_MCD daemon restarts the failed process. This cycle will repeat for a user-specified number of times before the failed process is not restarted.
 

Return Values

None. 
 

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026