HP XP7 Command View Advanced Edition Mainframe Agent Installation and Configuration Guide (TK981-96005, May 2014)

Using the YKALCSVC command to register
The following shows how to execute the YKALCSVC command. For details on the format of the
YKALCSVC command, see “Settings for using the YKALCSVC command” on page 21.
When the system starts or before you use XP7 mainframe agent, execute the YKALCSVC command
to register a user SVC.
Execute the command as follows with the SVC number specified:
START YKALCSVC,PARM='SVC-number'
An error is returned if another user SVC is already assigned to the SVC number specified here.
By omitting the PARM parameter, an unused SVC number between 200 and 255 is assigned. For
example:
START YKALCSVC
To delete a user SVC, specify DELETE as the parameter and execute YKALCSVC command. For
example:
START YKALCSVC,PARM='DELETE'
CAUTION:
• If you delete a user SVC using the YKALCSVC command while XP7 mainframe agent is running,
storage information may not be sent to Device Manager or Replication Manager correctly.
• If you register a user SVC using the YKALCSVC command while XP7 mainframe agent is running,
any already-executing CLI command will continue to execute in the user SVC defined in the
IEASVCxx parmlib member. The newly registered user SVC becomes available once a request
is issued from Device Manager or Replication Manager.
• 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, from the next IPL, use the
registered user SVC.
• If you delete a user SVC registered with the YKALCSVC command of an earlier XP7 mainframe
agent version, use the YKALCSVC command of an earlier XP7 mainframe agent version. You
must be careful when upgrading XP7 mainframe agent in a system containing multiple XP7
mainframe agent versions.
Installation and Configuration Guide 23