Systems Management API Support › Files Provided by CA VM:Secure for the RPC SMAPI Server

Files Provided by CA VM:Secure for the RPC SMAPI Server

The following files, installed using the instructions in the previous section, provide the support to use CA VM:Secure routines with the Systems Management API.

VMXAPI CSLLIB

This CSL library consists of a set of stub routines that route control to the VMXAPI module when the VSMSERVE server receives an RPC request.

VMXAPI MODULE

This module is called during the initialization of the VSMSERVE server machine. This module is a self-loading nucleus extension. When the code is loaded to memory, VMXAPI loads the VMXAPI CSLLIB to storage. When the VSMSERVE server calls any of the CSL routines, the stubs branch to this code.

The major function of VMXAPI MODULE is to pass control to the VMXSMAPI EXEC described below. It maps the CSL parameter lists to variables REXX can handle. It then concatenates the parameters together, with each parameter separated by a 4-byte length field. Next, a CMSCALL is issued to invoke the VMXSMAPI EXEC with the argument string as its argument. After control returns from the EXEC, VMXAPI retrieves the REXX function result and moves it to a buffer provided by the CSL routine caller.

VMXSMXIT EXEC

This EXEC replaces the IBM-supplied VSMEXIT EXEC. VMXSMXIT EXEC accesses the appropriate disks and initializes the VSMSERVE server machine for use with CA VM:Secure.

VMXSMAPI EXEC

The VMXSMAPI EXEC is a large SELECT construct, with a WHEN clause for each API routine. It retrieves the original CSL parameters to a stem ‘p’, where p.1 is the first argument, p.2 is the second, and so on. The arguments to each API routine are validated and then used to construct CA VM:Secure commands to carry out the requested system management function.

Note: For more information about which CA VM:Secure command is issued for each Systems Management API routine, see Install CA VM:Secure API Components in the RPC SMAPI Server (VSMSERVE).

VMXSML2P REXX

Used by VMXSMAPI EXEC to convert logical file line images to REXX parameters.

VMXSMP2L REXX

Used by VMXSMAPI EXEC to convert REXX parameters to logical file line images.