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 IDDescriptionOutput destination
KFCA00881-IHelp messageStandard output, standard error output
KFCA00890-EError occurred during scdhold command processing.Standard error output
KFCA00891-EUsage of the scdhold command is invalid.Standard error output
KFCA00892-Escdhold command execution environment has not been set up.Standard error output
KFCA00893-ESpecified server name is invalid.Standard error output
KFCA00894-Escdhold command cannot be executed due to inconsistent versions.Standard error output
KFCA00895-EBatch shutdown processing failed.Standard error output
KFCA00897-ESpecified 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.