HP P9000 Command View Advanced Edition Software Mainframe Agent Installation and Configuration Guide

4. Create space for the datasets to be transferred (execute the edited YKAGALLO job).
The YKAGALLO job creates the sequential dataset space for transferring the P9000 mainframe
agent object archive and the REXX alternate library archive to the host machine.
5. From the PC, transfer in binary mode the P9000 mainframe agent object archive and the REXX
alternate library archive to the transfer dataset space allocated on the host machine.
You need to transfer the REXX alternate library archive only if you plan to install a REXX alternate
library.
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.
Installing the REXX alternate libraries
If you do not have one of the following REXX libraries, you need the REXX alternate library (FMID:
HWJ9143, JWJ9144). The MCS (Modification Control Statements) corresponding to this FMID are
stored in the MFAGENT.Vnnnn.SMPMCS.XMIT dataset listed in Table 2.
• IBM Library for REXX on zSeries Release 4 (FMID HWJ9140)
• IBM Library for REXX on zSeries Alternate Library (FMID HWJ9143)
For details on how to install the REXX alternate library, see Chapter 6 in the manual Program Directory
for IBM Library for REXX on zSeries Alternate Library (GI10-3243-01).
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 P9000 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 P9000 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 P9000 mainframe agent to the IEFPDSI dd name
of the MSTJCLxx parmlib member.
• Copy the YKALCSVC member from the cataloged procedure library of P9000 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.
Mainframe Agent Installation and Configuration Guide 21