OpenTP1 Version 7 Operation

[Contents][Index][Back][Next]

mcftactle (Release shutdown of logical terminals)

Format

mcftactle [-s MCF-communication-process-identifier]
          [-c connection-ID] -l logical-terminal-name
          [-t shutdown-release-type]

Function

The mcftactle command releases logical terminals from shutdown status.

Options

-s MCF-communication-process-identifier~<numerals (0-9), a-f> ((01-ef))

Specifies the MCF communication process identifier of the MCF communication service controlling the target logical terminal. No more than one MCF communication process identifier can be specified.

If this option is omitted, the mcftactle command is executed on all MCFs. This means that the overhead required to search for the MCF communication services is added to the processing load of the operation commands.

When the configuration includes lots of MCF communication services or large amounts of operation commands are entered for the operation, use the -s option to specify an MCF communication process identifier.

-c connection-ID~<identifier, 1-8 characters>

Specifies the connection ID of a logical terminal whose shutdown status is to be released.

Neither multiple connection IDs nor the ID of a group of connections can be specified.

-l logical-terminal-name~<identifier, 1-8 characters>

Specifies the name of a logical terminal whose shutdown status is to be released.

If the -c option is specified, the logical terminal name corresponding to the specified connection ID must be specified.

A maximum of eight logical terminal names can be specified. When entering large amounts of inputs for the operation, specify more than one logical terminal or specify a group of logical terminals to increase the number of logical terminals to be processed in parallel by one command while reducing the number of commands to be entered.

To specify multiple logical terminal names, separate them by a space and enclose the entire string of logical terminal names in double quotation marks ("). The same logical terminal name cannot be duplicated when specified.

The asterisk (*) can be used in the specification to indicate a group of logical terminal names. The name of a group of logical terminals cannot coexist with the names of logical terminals for which no grouping is specified. A group name must be enclosed in double quotation marks (").

*
Specifies that the shutdown status of all logical terminals is to be released.

character-string*
Specifies leading characters of a logical terminal name when the shutdown status of all logical terminals with names beginning with the specified character string is to be released.

<Example of specifying more than one logical terminal>
To specify len1, len2, and len3, code: -l "len1[Figure]len2[Figure]len3"

<Example of specifying a group of logical terminals>
To specify all logical terminals beginning with len, code: -l "len*"

-t shutdown-release-type~<1-8 character identifier><<all>>

Specifies the type of releasing shutdown.

all
Releases a logical terminal from shut-down terminal status and queue status.

term
Releases a logical terminal from shut-down terminal status.

queue
Releases a logical terminal from shut-down queue status.

It may not be specified under some protocols; when specified, the option is ignored.

Output messages

Message ID Description Output destination
KFCA10350-I mcftactle command has been entered. Standard output
KFCA10351-E MCF startup processing is underway. Standard error output
KFCA10352-E MCF termination processing is underway. Standard error output
KFCA10353-W Input format is invalid. Standard error output
KFCA10354-E Memory is inadequate. Standard error output
KFCA10355-W Specification of an argument is invalid. Standard error output
KFCA10356-E Overtime occurred during process. Standard error output
KFCA10357-E Overtime occurred in MCF. Standard error output
KFCA10358-E Error occurred in an internal function. Standard error output
KFCA10359-W Response to mcftactle command input source failed. Message log file or standard error output
KFCA10371-I mcftactle command has been accepted normally. Standard output
KFCA10373-E mcftactle command terminated abnormally. Standard error output
KFCA10380-E Retrieval of remote process failed. Standard error output
KFCA10381-E Specified connection has not been cataloged. Standard error output
KFCA10382-E A specified logical terminal has not been cataloged. Standard error output
KFCA10390-E Correspondence between specified connection ID and logical terminal name is invalid. Standard error output
KFCA10391-E mcftactle command is not supported. Standard error output
KFCA10395-E The name of an unconnected logical terminal is specified in specified connection. Standard error output
KFCA10503-I Help message Standard output
KFCA16402-E RPC error occurred during command processing. Standard error output

In addition to these messages, messages for the protocol being used are output; for details, see the applicable protocol manual.