Using the YKALCSVC command to register

Business Continuity Manager Installation Guide

Version

9.8.7

File Size

1.1 MB

Audience

anonymous

Part Number

MK-95HC104-41

To dynamically register a user SVC, execute the YKALCSVC command when the system starts or before you use Business Continuity Manager.

YKALCSVC command format

The following shows the formats of the YKALCSVC commands. For details about command formats, see Conventions in syntax explanations.

Format

START YKALCSVC[,PARM='{SVC-number|DELETE}']

Function: Registers or deletes a user SVC.

parameters

SVC-number ~ <numeric characters> ((200-255)): Specifies a SVC number to assign to a user SVC.

DELETE: Specified to delete a user SVC.

If you omit the optional PARM= part of the command, an unused SVC number between 200 and 255 is assigned. However, if a user SVC has already been registered by using the YKALCSVC command, the user SVC will be overwritten with the same SVC number.

Return codes

Table. YKALCSVC command return codes list
Return code	Meaning
`0`	The command ended normally.
`4`	The user SVC is already registered with a different SVC number.
`16`	Registration or deletion of the SVC number failed.
`20`	Processing stopped due to an error (the specified value or execution environment is invalid).

Example of registering a user SVC

Execute the following command to specify the SVC number:

START YKALCSVC,PARM='SVC-number'

An error is returned if another user SVC is already assigned to the SVC number specified here.

Example of deleting a user SVC

To delete a user SVC, specify DELETE as the parameter and execute YKALCSVC command.

START YKALCSVC,PARM='DELETE'

Tip: To use the YKALCSVC command so that a new version of a user SVC overwrites a user SVC already registered by the YKALCSVC command, execute the command with the same SVC number specified, or without specifying the PARM parameter.

Note:

To use the YKALCSVC command to register a user SVC with a new SVC number different from an already registered SVC number, delete the user SVC and then re-register the user SVC.
If you delete a user SVC using the YKALCSVC command while Business Continuity Manager is running, CLI commands that are being executed terminate abnormally.
If you use the YKALCSVC command to register a user SVC while Business Continuity Manager is running, CLI commands that are being executed will use the user SVC defined by the IEASVCxx parmlib member. The registered user SVC will take effect the next time a CLI command is executed.
The user SVC registered with YKALCSVC command is lost when an IPL is performed. Before you perform another IPL, we recommend you specify one of the following settings:

-Add the YKALCSVC command to the COMMNDxx parmlib member; so that the user SVC is automatically registered each time an IPL is performed.

-Define the user SVC in the IEASVCxx parmlib member, and then use the user SVC that is registered at the next IPL.
The user SVC routine registered with the YKALCSVC command of Business Continuity Manager 5.1 or later cannot be deleted by using a YKALCSVC command of Business Continuity Manager earlier than version 5.1. So, be careful when you perform an upgrade in an environment where multiple versions are used.
If you perform a new installation of Business Continuity Manager in an environment in which Tiered Storage Manager for Mainframe or MAR is installed, you need to be careful when registering a user SVC. For details, see Notes on user SVC registration.