Task M9C0I021: Modify MLAVM, USERLID, and USERXLID COPY

Installation Procedure › Test System Installation Tasks › Task M9C0I021: Modify MLAVM, USERLID, and USERXLID COPY

Task M9C0I021: Modify MLAVM, USERLID, and USERXLID COPY

This task builds the ACF2USER MACLIB. The ACF2USER MACLIB contains several MACRO and COPY files, including the MLAVM MACRO and the USERLID and USERXLID COPY files. The MLAVM MACRO defines the layout of the standard VM minilid (MLID). The USERLID COPY and USERXLID COPY files contain any user‑defined fields that are included in the CA ACF2 for z/VM logonid record. The LIDREC MACRO copies these two COPY files. They become part of the LIDREC DSECT that maps the logonid record. USERLID is for fields in the first user section of the logonid record. USERXLID is for fields in the second user section of the logonid record.

If you are adding @CFDE entries in the ACFFDR for user‑defined fields, you must add the corresponding symbolic label to either USERLID or USERXLID and then rebuild the ACF2USER MACLIB. Once it is built, you must assemble the ACFFDR (done in a later step). This step, M9C0I021, modifies these files and rebuilds the maclib.

See "Field Definition Record" for more information on the ACFFDR, which uses these macros.

To complete this task:

Select task M9C0I021 from the Task Selection Menu.

The following panel appears:

M9C0I021 Modify MLAVM, USERLID and/or USERXLID CA ACF2 for z/VM ====> This step builds the ACF2USER maclib. You may edit MLAVM MACRO, USERLID COPY and/or USERXLID COPY before building the MACLIB. To edit the desired file, put a Y next to the filename and press PF6. To create a new update, overtype the Filetype and Description fields before pressing PF6. Edit? Filetype Description........................... MLAVM MACRO: N ACFUSER1 USR UPDATE FILE FOR MLAVM USERLID COPY: N ACFUSER1 USR UPDATE FILE FOR USERLID USERXLID COPY: N ACFUSER1 USR UPDATE FILE FOR USERXLID To build the ACF2USER MACLIB, press PF2. The maclib will be built using VMFMAC. Press PF6 to edit the indicated COPY/MACRO file(s). Press PF2 to build ACF2USER MACLIB. PF1=Help 2=BuildMac 3=End 4=Return 5= 6=Xedit PF7= 8= 9= 10= 11= 12=

Type Y to indicate you want to modify the MLAVM macro, the USERLID COPY file, and the USERXLID COPY file.

Press PF6 to edit the files you selected. The first file you selected displays over the bottom of the panel. In the example below, the file being modified is the USERXLID COPY file:

M9C0EDIT/M9C0I021   USERXLID COPY *                     CA ACF2 for z/VM 
 ===>
 ‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑
 If you add any fields to the LIDREC, you must update this copy file
 and the USERLID COPY file. The installation exec lets you edit both
 files.
 
 The USERXLID file is called in by the LIDREC MACRO, and defines
 user fields in a user area of the LIDREC DSECT.
 
 To use the ACF command to display or change any of these fields, you
 must describe them with an @CFDE entry in the ACFFDR.
 
 
DB = Scroll directions backward      DF = Scroll directions forward
________________________________________________________________________
 USERXLID COPY   E1 F 80 Trunc=80 Size=21 Line=1 Col=1 Alt=0
 
 *COPY USERXLID                                           B301006  ====
 *                                                        TM83211A ====
 *  USERXLID COPY ‑ USER STATEMENTS FOLLOW                TM83211A ====
 *                                                        TM83211A ====
 *  USER STATEMENTS GO HERE                                        ====
 ===>

After you make your changes, press PF2 to save them.

Press PF2 to create the ACF2USER MACLIB.

A message appears on the panel confirming that CA‑ACTIVATOR is building the ACF2USER MACLIB:

M9C0I021   Modify MLAVM, USERLID and/or USERXLID          CA ACF2 for z/VM 
 ===>
 Building ACF2USER MACLIB ...

When processing is complete, a message appears on the panel confirming that the ACF2USER MACLIB is built:

M9C0I021  Modify MLAVM, USERLID and/or USERXLID           CA ACF2 for z/VM 
 ===>
 ACF2USER MACLIB built. Press PF3 to exit.

Press PF3 to return to the Task Selection Menu.