Space announcement This documentation space provides the same content as before, but the organization of the content has changed. The content is now organized based on logical branches instead of legacy book titles. We hope that the new structure will help you quickly find the content that you need.

Define System Labels (9.9)

Related Topics

Customizing-after-installation

Quick-Reference

Using-Code-Debug-CICS-with-Assembler-program

Using-Code-Debug-CICS-with-COBOL-program

The Define System Labels screen (9.9) is used to create, delete, list, and modify system labels that identify storage locations. Labels are used to access storage locations easily without repeatedly entering base numbers and offsets. The user can then use the labels on the Storage Exceptions (9.7) screen to exempt specific storage locations from storage protection.

System labels differ from User Labels (1.9) screen. System labels can be used by any Code Debug CICS user; user labels are reserved for the user who established them. System labels can also be used on the Storage Exceptions (9.7) screen, while user labels cannot.

Access the following screen by typing the number 9 on the System Facilities Menu (9), or as described in Transferring Between Screens.

Define System Labels Screen (9.9)

 ------------------------- DEFINE SYSTEM LABELS (9.9) ---------------------C024
 COMMAND ===>                                                   SCROLL ===> CSR
 MODULE: CCASDCTL CSECT: CCASDCTL

DEFAULT BASE LABELS:  CSA  DCT  EIS  FCT  MOD  OFL  PGM  TCA  TCT
                       ADDR  PADDR  PLEN   INITCOMM  MQMD  MQDATA

       USER        BASE       ENTRY OR     + OR -     USE            RESULTING
 DEL    LABEL       LABEL      PGM-NAME     OFFSET   CONTENT LENGTH     VALUE
------------------------------------------------------------------------------
  _    ________    ________    ________    _________    _   ________
  _    ________    ________    ________    _________    _   ________
  _    ________    ________    ________    _________    _   ________

Usually, users cannot define absolute storage addresses of CICS or transaction control blocks before startup. Most of these locations can vary depending on the region started or the number of transactions executing. These factors make defining storage protection exceptions difficult. Using default base labels and system labels as building blocks simplifies this task by allowing you to equate labels to relative locations.

A system label can build upon any other system label or default base label. This means that using default base labels like CSA, users can locate and label any CPU, CICS, or transaction storage location.

Input Fields

DEL

Type the D (Delete) line command to delete a system label entry. Code Debug CICS does not allow an entry to be deleted if another entry references it as a base or an offset. When ending the Code Debug CICS session, system labels that you have created are retained unless they are deleted here.

USER LABEL

Your identifier for this label that identifies a specific storage location. The label must begin with an alphabetic character and cannot duplicate any other default base or user-defined label.

BASE LABEL

Valid user label defined on an earlier entry or a default base label. Code Debug CICS defines the new system label storage address by using the resolution of the existing label as a base. If you base a new system label on another system label, that other existing label cannot be deleted until this relationship is ended.

ENTRY OR PGM-NAME

Valid program name if the existing label is PGM. Enter the name of the particular entry to access. If the EXISTING LABEL field is PADDR, PLEN, FCT, DCT, or TCT, this field is optional. For any other existing label, this field must be filled with spaces.

+ OR - OFFSET

Hexadecimal number or an existing system label preceded by a plus (+) or minus (-) sign. If no sign is entered, the offset is assumed to be positive. If using an existing system label, the user cannot delete that existing system label until this relationship is ended.

USE CONTENT

Valid entries are N, Y, or a number from 1 to 4. Entries Y and 4 give the same results.

  • N: Resolution of the existing label plus the value of the offset is the value for the new system user label.
  • Y or 4: Four bytes at the location described by the existing label and offset are used as the resolution for the new system label.
  • 1, 2, or 3: Bytes 1, 2, or 3 at that location are used as the value for the new system label. This value is resolved again at the time of a storage violation.

LENGTH

Actual length for the system label in the range of 1 to 99999999. The following formats are available for input:

  • nnnnnnnn: A decimal number ranging from 0 to 99999999.
  • Xnnnnnnn: A hexadecimal number ranging from 0 to FFFFFFF.
  • X'nnnnnn: A hexadecimal number ranging from 0 to FFFFFF.
  • X'nnnnn': A hexadecimal number ranging from 0 to FFFFF.
  • X"nnnnnn: A hexadecimal number ranging from 0 to FFFFFF.
  • X"nnnnn": A hexadecimal number ranging from 0 to FFFFF.

Output Field

RESULTING VALUE

Current resolution is displayed in this field to help identify incorrect entries. All addresses and lengths are resolved again at the time they are used.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*