LOCATE Command

Finds a label, line number, offset, or special area. Use the syntax shown next; select one operand from the list.

LOCATE label
       line‑number
       hex‑offset
       .xx

label: Replace with any valid label up to 31 characters long. Valid labels include data names, CSECTs, procedures, and paragraph names. A COBOL paragraph name consisting of all numbers is not a valid label.
line‑number: Replace with any line number.
hex‑offset: Replace with an offset from an assembler program. Offsets are indicated by a leading + character.
.xx: Replace with the appropriate special indicator. Special indicators are language‑dependent. Select one from the appropriate list.

For COBOL, select an indicator from the following list:

Special Indicator Meaning

.PD Procedure Division

.WS Working Storage Section

.LC Local-Storage Section

.LS Linkage Section

.DM DMPA

.PM COBOL/VS PMAP/CLIST

.CL COBOL/VS PMAP/CLIST

.OF COBOL II OFFSET/LIST

.LI COBOL II OFFSET/LIST

.DX Data Cross‑Reference

.PX Procedure Cross‑Reference

.EM Error Messages

For PL/I, select an indicator from the following table:

Special Indicator Meaning

.AG Aggregate List

.SR Storage Registers

.SS Status Storage

.VS Variable Storage

.OF Offsets

.GC Generated Code

.PX Procedure Cross‑Reference

.LX Label Cross‑Reference

.DX Data Cross‑Reference

.EM Error Messages

For Assembler, select an indicator from the following table:

Special Indicator Meaning

.C1 First CSECT

.1C First CSECT

.MC Macro Catalog

.XR Cross‑Reference

.LI Literals

.EM Error Messages

The short form is LOC or L; no PF key is assigned.