OpenTP1 Version 7 Operation

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

scdhold (Shut down scheduling)

Format

scdhold {-a|-s server-name [-c server-name]|-ap
        |-s server-name -p}

Function

The scdhold command shuts down the scheduling of a server or service working under the scheduling service. However, the scheduling of a service can be shut down only with service_hold=Y (shut down on a service basis) specified in the user service definition.

This command cannot be used to shut down scheduling for the system service or for MHP (a server for which type=MHP is specified in the user service definition or a server for which type=MHP is specified in the user service default definition and for which the type operand is omitted from the user service definition). To shut down scheduling for MHP, the mcftdctsv command must be used.

Options

-a

Specifies that scheduling for all servers operating under the scheduling service, except for MHP and the system service, is to be shut down.

-s server-name~<identifier, 1-8 characters>

Specifies the name of a server whose scheduling is to be shut down.

-c service-name~<1-31 character identifier>

Shuts down the scheduling of the server specified in the -s option or the specified service. For a server for which service_hold=Y (shut down on a service basis) has not been specified in the user service definition, an error message (KFCA00890-E) is displayed. When this option is omitted, the scheduling of the server specified in the -s option is shut down.

-ap

Shuts down the scheduling of all servers (except MHP and the system service) working under the scheduling service. Service requests from clients are accepted.

-s server-name -p~<1-8 character identifier>

Shuts down the scheduling of the server with the specified server name. Service requests to applicable servers are accepted.

Output messages

Message ID Description Output destination
KFCA00881-I Help message Standard output, standard error output
KFCA00890-E Error occurred during scdhold command processing. Standard error output
KFCA00891-E Usage of the scdhold command is invalid. Standard error output
KFCA00892-E scdhold command execution environment has not been set up. Standard error output
KFCA00893-E Specified server name is invalid. Standard error output
KFCA00894-E scdhold command cannot be executed due to inconsistent versions. Standard error output
KFCA00895-E Batch shutdown processing failed. Standard error output
KFCA00897-E Specified server has already been shut down. Standard error output

Notes

You cannot apply the scdhold command to the following servers. If you specify any of these servers in the -s option, the command outputs the message KFCA00893-E and returns an error.