Local Service › Create Local Service

Previous Topic: Local Service

Next Topic: Apply Local Service

Create Local Service

This section documents the steps to create a REXX source update file.

  1. Issue the following command to setup the VMSES/E search order for the product on the VMANAGER user ID: 
    VMFSETUP ppfname component ( LINK
  2. Assign a local tracking number to this modification. The suggested format of this tracking modification identifier is the letter L followed by a four-digit number. In this example, we will use L0001 as the modification identifier (MODID).
  3. Create an AUX file for the local modification or add an entry to the AUX file if it already exists. The filename of the AUX file is the same as the filename of the source file being modified. The AUX file filetype is determined by the LCL entry in the CNTRL file for the product being updated. It is defined to be AUXLCL. In this example, we will update source file MYFILE $EXEC$. Therefore we will first create or update the MYFILE AUXLCL file.
  4. Add a line at the top of the file using XEDIT. The line is of the form: 
    UPL0001 LCL LCL0001 * Test Local Modification

    The record consists of three tokens followed by a comment describing the update. The required tokens are specified in this order:

    1. The first token is the filetype of the actual update file.
    2. The second token is the Service Level Identifier. The required identifier is LCL.
    3. The third token is composed of the letters LC followed by the five character MODID value.
    4. The comment is any string beginning with an asterisk.

    The AUX file must be created on or moved to the LOCALMOD disk in the product search order.

  5. Use the XEDIT command with the CTL option, and the filename of the product specific CNTRL file to create the update file. The filename of the CNTRL file is defined by the value on the CNTRL tag in the Product Parameter File for the product. In this example, we will use the VMX CNTRL file. Issue the following command: 
    XEDIT MYFILE $EXEC$ ( CTL VMX

    Add, delete, or modify lines in the file to program the desired update. When you file the changes, XEDIT will produce a standard CMS UPDATE file. The file must be created on or moved to the LOCALMOD disk in the product search order.