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

6. Extract objects and libraries to the space allocated for the execution datasets (execute the edited
YKAGINST job).
The YKAGINST job allocates the execution dataset space, and extracts the objects and libraries
from the transfer dataset archives to the execution dataset space.
Settings for using the YKALCSVC command
The YKALCSVC command registers the user SVC, and is started by the OS START command.
To use the YKALCSVC command:
1. Define the LINKLIB library (the load library of XP7 mainframe agent) in the PROGxx parmlib
member, and then register APF authorization by using the SETPROG APF,ADD command.
2. Specify the LINKLIB library (the load library of XP7 mainframe agent) in the cataloged procedure
of the YKALCSVC command by using the STEPLIB DD statement.
3. Perform either of the following:
• Link the cataloged procedure library of XP7 mainframe agent to the IEFPDSI dd name of
the MSTJCLxx parmlib member.
• Copy the YKALCSVC member from the cataloged procedure library of XP7 mainframe agent
to the user PROCLIB.
Once you have added the YKALCSVC command in the COMMNDxx parmlib member, it is automatically
executed at the time of an IPL.
The following shows the YKALCSVC command format. For details on the symbols used to explain the
command syntax, see Table 25. For details on the command syntax elements, see Table 26.
Format
START YKALCSVC[,PARM='{SVC-number | DELETE}']
Function
Registers or deletes a user SVC.
Parameters
SVC-number ~ <numeric characters> ((200 to 255))
Specifies an 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.
Return codes
Used to indicate task status, as shown in the following table.
Table 4 YKALCSVC command return codes list
MeaningReturn code
The command ended normally.
0
The SVC number is already registered.
4
Registration or deletion of the SVC number failed.
16
Installation and Configuration Guide 21