Previous Topic: #GTABGEN SyntaxNext Topic: #GTABGEN Usage


#GTABGEN Parameters

security-label,activity-number

Associates an online debugger security label with an activity number.

Security-label specifies a label with which you can associate one or more online debugger security categories.

Security-label must be one alphabetic character (A through Z). You can define at most 26 security labels in the #GTABGEN macro.

Activity-number specifies the activity number you are associating with security-label. Activity-number must be a numeric value in the range 1 through 256.

security-category

Specifies the online debugger security category with which you are associating the activity number or security label.

Security-category can be any value listed in the "Category" column of the following table, which presents each online debugger security category and its description:

Category

Description

ALLR

Any entities named in the following categories can be retrieved.

ALLU

Any entities named in the following categories can be updated.(1)

ASYSPGR

CA ADS runtime system programs (ADSOMAIN, ADSORUN1, and ADSODBUG) can be retrieved.

ASYSPGU

CA ADS runtime system programs can be updated.(1)

ASYSTGR

Storage acquired by the CA ADS runtime system can be retrieved. System storage includes the control block for the online work area (OWA), the online terminal block (OTB), the online terminal block extension (OTBX), and the variable dialog block (VDB).

ASYSTGU

Storage acquired by the CA ADS runtime system can be updated.(1)

AUPGMR

CA ADS user programs can be retrieved. These include the fixed dialog block (FDB), the application definition block (ADB), and the task application table (TAT).

AUPGMU

CA ADS user programs can be updated.(1)

SHSTGR

Shared storage can be retrieved.

SHSTGU

Shared storage can be updated.(1)

UPGMR

User programs, subschemas, maps, and tables can be retrieved.

UPGMU

User programs, subschemas, maps, and tables can be updated.(1)

USTGR

User storage can be retrieved.

USTGU

User storage can be updated.(1)

(1) Update mode also implies that programs can be retrieved. In retrieval mode you can list and set breakpoints.

security-label

Specifies the online debugger security label that you are associating with security-category.

This occurrence of security-label must match a security label that is specified in a prior parenthesized list in the macro.

activity-number

Specifies the online debugger activity number that you are associating with security-category.