The NAME control record specifies the me.ber or module and CSECT that
contain the data to be verified or replaced by the ZAP operation. The format of the NAME control record is: HA!E !here:
{ meabername } [csectna lie] modulename { Ilembernaille }
lIlodulenalle
is the member or module that you want to be searched for the
desired CSECT. csectname is the name of the desired control section. You must specify
csectname if the CSECT you wish to modify is in a CftS TITLlB
(that is, TITLIB created by the TITLIB command from CftS TEXT decks that do not have a NAME card following the END card). The directory of a cas TXTLIB contains only CSECT names and no
.ember names. The CSECT name specified in the HAKE record is
compared with CSECT names in the directory. If a CSECT match
is found and no member name match is found, the member selected is the one that contains the CSECT name. ,The csectname is optional if the CSECT you wish to modify is a
LOADLIB or an OS TITLIB (that is, a TITtlE created by the TXTLIB command from CMS TEXT decks that have a NAME card after
the END card). The dictionaries of the specified libraries
are searched for the member name and the member is then
searched for the CSECT name, if you specified one. If you do
not specify csectname for a LOADLIB or an OS TITtIB, the
program uses the first control section. The csectname is
optional for a MODULE file. The module named in the NAME control record is located and, if you specified csectname, the
first record is read to determine the number of records in the module and the availability of a leader table, which the
program can then search for the csectnalBe. If you do not
specify csectname, the program uses the beginning location of
the module. You are not allowed to specify csectname if the
module was created with the HOMAP option. The NAftE control
record must precede the BASEl VER, and REP control records.
If it does not, the program sets the NOGO switch on.
The BASE control record adjusts displacement values for subsequent VED or REP control records for a CSECT whose starting address is not
location zero in an assembly listing. The foraat of the BISE control
record is: BASE address Section 4. VM/370 Service Prograas 203
address is the starting address of the CSECT. The address must be
two, four, or six hexadecimal digits. For example, for a CSECT starting at location 400, you would specify the BASE 0400 in the BASE control record. If a subsequent VER card
requests verification of location 0408, the BASE of 0400 is
subtracted from and the program verifies location 08 in
the CSECT. This example applies if you specify TITLIB, LOADLIB, or MODULE and the module map is present. However, if
ne module map is present for a ftODULE file (that is, the
module was generated with the IOftAP option), then all
operations are performed as if the BASE address is location O. For example, if you specify a BASE of 400 and the address you wish to inspect or modify is 408, then you must specify 08 and
not 408 in REP and VER control records. The address in this
case is from the start of the module. If you do not specify
csectname in the HAME control record. vou cannot specify anY BASE value other than 00. The BASE control record is optional. See the discussion under "VER or VERIFY Contrel
Record." If specified, the BASE control record must follcw
the BAftE record, but it need not follow the lAME record immediately. For example, you could have the following
sequence of control records: NAftE, VER, REP, BASE, VER, REP. The VER control record requests verification of instructions or data
within a CSECT. If the verification fails, the Frogram does not perform
a subsequent REP operation until it encounters another IAftE control
record.
The VER control record is optional. ftore than one VER record can
follow a single lAME record.
The format of the VER control record is: {
VERIFY
} VER disp data disp is the hexadecimal displacement of the data to be inspected
from the start of the CSECT, if you did not submit a BASE control record for this CSECT. If you did submit a BASE control record, then disp is the actual location of the data.
The disp must be tvo, four, or six hexadeci.al digits. This displacement does not have to be aligned on a full word
boundary. If this displacement value is outside the limits of
the CSECT specified by the preceding IAftE control record, the VERIFY control record is rejected.
data is the data against which the data in the CSECT is to be compared. This must be an even number of hexadecimal digits. Por example, if the location you wish to verify is 3CC, and
the CSECT begins at location 2BO, you can either issue: 204 VM/370 OFerator's Guide
Previous Page Next Page