%AID

The %AID command can be used to declare global settings or to revoke the settings valid up until then.

• With the CCS operand, you specify a CCS for interpreting characters if no CCS is explicitly indicated in the %DISPLAY command. Unicode character sets are not
  allowed.

• With CHECK you define whether an update dialog is to be initiated prior to execution of the %MOVE or %SET commands.

• With REP you define whether memory updates of a %MOVE command are to be stored as REPs.

• With SYMCHARS you define whether AID is to interpret a "-" in program, data and statement names as a hyphen or as a minus sign.

• With OV you direct AID to take the overlay structure of a program into account.

• With LOW you direct AID to convert lowercase letters of character literals and names to uppercase, or to interpret them as lowercase. The default value is OFF.

• With DELIM you define the delimiters for AID output of alphanumeric data. The vertical bar is the default delimiter.

• With LANG you define whether AID is to output %HELP information in English or German.

• With EBCDIC you specify the EBCDIC encoding of a C string in the form of a coded character set name (CCSN). AID uses this CCSN, for example, in the case of conversions from and to UTF16/UTFE strings.

• With the operand LEV , you can activate the output of levels within the call hierarchy produced by the %SDUMP %NEST AID command.

Command	Operand
%AID	{   CCS [= {<coded-character-set> | *USRDEF}]   | CHECK [= {ALL|NO}]   | REP [= {YES| NO }]   | SYMCHARS [= {STD|NOSTD}]   | OV [= {YES| NO }]   | LOW [= {ON|OFF|ALL}]   | DELIM [= {C'x'|'x'C|'x'|'|'}]   | LANG [= {D | E}]   | EBCDIC={ *USRDEF | <ebcdic-coded-character-set>}   | LEV [= {ON|OFF}] }

Declarations made using %AID remain valid until superseded by a new %AID command or until /LOGOFF or /EXIT-JOB.

%AID can only be issued as an individual command, it must never be part of a command sequence or a subcommand.

The %AID command does not alter the program state.

CCS

<coded-character-set>

Name of the CCS (<name 1..8>) for interpreting AID data. XHCS must know the indicated character set. Otherwise, AID rejects the statement with the message
AID0555.

*USRDEF

CCSNAME of the character set, that is assigned to the user ID. *USRDEF is the
default value of CCS.

If you specify the CCS operand in a %AID command, AID checks if the CCSNAME is permitted by XHCS. If XHCS doesn‘t know the CCSNAME, the command is rejected and the current CCS value is kept.

The following AID command enables you to display a complete list of CCSNAMEs that are supported by XHCS:

%SHOW %CCSN

CHECK

ALL

Prior to execution of a %MOVE or %SET command, AID conducts the following update dialog: OLD CONTENT: AAAAAAAA NEW CONTENT: BBBBBBBB % AID0274 CHANGE DESIRED? REPLY (Y = YES; N = NO) ? N AID0342 NOTHING CHANGED If Y is entered, the old memory contents are overwritten and no further message is issued. In procedures in batch mode, AID is not able to conduct a dialog and always assumes Y. The old or new contents are output to SYSOUT. If SYSOUT is reassigned, these outputs cannot be seen at the terminal. This also applies if the %MOVE or %SET command was specified with the CMD macro and output to SYSOUT has been defined. In contrast, message AID0274 and, where appropriate, AID0342 are always sent to the terminal medium.

NO

%MOVE and %SET commands are executed without an update dialog.

If the CHECK operand is entered without specification of a value, AID assumes the default value (NO).

REP

YES

In the event of a memory update caused by a %MOVE command, LMS correction statemements in SDF format (REPs) are created. If the object structure list is not available, AID does not create any REPs and issues an error message to this effect. AID stores the corrections in a file with the link name F6. The MODIFY-ELEMENT statement must then also be inserted for the LMS run. Care should be taken that no other outputs are written to the file with link name F6. If no file with link name F6 is registered (cf. %OUTFILE), AID creates the AID.OUTFILE.F6 file, to which it then writes the REP. User-specific REP files must be created with access method SAM. REP files created by AID are likewise defined with access method SAM, record format V and opening method EXTEND. The file remains open until it is closed via %OUTFILE or until /LOGOFF or /EXIT-JOB.

NO

No REPs are generated.

If the REP operand is entered without a value specification, AID inserts the default (NO). The REP operand of the %MOVE command can supersede the declaration made with %AID, but only for this particular %MOVE command. For subsequent %MOVE commands without a REP operand, the declaration made with the %AID command is valid again.

SYMCHARS

STD

A hyphen "-" is interpreted as an alphanumeric character and can, as such, be used in program, data and statement names. A hyphen is only interpreted as a minus sign if a blank precedes it.

NOSTD

A hyphen "-" is always interpreted as a minus sign and cannot be used as a part of names.

If the SYMCHARS operand is entered without a value specification, AID inserts the default value (STD).

OV

YES	Mandatory specification if the user is debugging a program with an overlay structure. AID checks each time whether the program unit which has been addressed originates from a dynamically loaded segment.
NO	AID assumes that the program to be debugged has been linked without an overlay structure. AID does not check whether the CSECT information or LSD records belong to the program unit which has been addressed.

If the OV operand is entered without a value specification, AID assumes the default (NO).

LOW

ON	Lowercase letters in character literals and in program, data and statement names are not converted to uppercase.
OFF	All lowercase letters from user entries are converted to uppercase.
ALL	Has the same effect as %AID LOW=ON, the distinction between uppercase/lowercase letters also being taken into account when all BLS names are entered. In addition, upper and lower case entries in character literals and in program, data and instruction names are retained, as when %AID LOW=ON is specified. The following BLS names are used by AID: Context names of the CTX qualification Load unit names of the L qualification Link module names of the O qualification CSECT names of the C qualification COMMON names of the COM qualification Names of compilation units of the S qualification

If no LOW operand has been entered in a debugging session, OFF applies.

If the LOW operand is input without a value specification, AID assumes the default (ON). In this case LOW=OFF must be entered if conversion to uppercase is to be reactivated.

DELIM

C’x’ | ’x’C | ’x’

	With this operand the user defines a character as the left-hand and right-hand delimiter for AID output of symbolic data of type ’character’ (%DISPLAY and %SDUMP commands).
| ¯	The standard delimiter is the vertical bar.

If the DELIM operand is entered without value specification, AID inserts the default value (|).

LANG

D	AID outputs information requested with %HELP in German.
E	AID outputs information requested with %HELP in English.

If the LANG operand is entered without a value specification, AID inserts the default (D). The SDF command MODIFY-MSG-ATTRIBUTES TASK-LANGUAGE=D also allows you to receive the AID messages in German. The update dialog (see CHECK operand) is not affected by this.

EBCDIC

*USERDEF

Encoding table which is assigned to the BS2000 ID. AID fetches the information during initialization for a task or when *USRDEF is specified. Changing the encoding table for the ID takes effect only after *USRDEF has been entered again.

<ebcdic-coded-character-set>

CCSNAME of a 1-byte EBCDIC code as supported by XHCS. This name can also be specified in the CODED-CHARACTER-SET operand of the BS2000 command CREATE-FILE.
When this command is entered, AID checks that the CCSNAME is permissible using XHCS. If the CCSNAME is unknown to XHCS or not 1-byte EBCDIC, the command is rejected and the current setting is retained.

AID uses the EBCDIC table which is selected via the %AID command when conversion needs to be performed between a UTFE/UTFE16 string and a C string.

The EBCDIC encoding table selected is also used to interpret the input characters (SYSCMD, SYSDTA) and character representation in outputs (SYSOUT, SYSLST).

If no unique code table is assigned to the input and output media (with CODED-
CHARACTER-SET=*NONE for the relevant file or CODED-CHARACTER-SET=7-BIT for the terminal (TERMINAL-OPTION)), by default the medium is assigned the user ID’s CODED-CHARACTER-SET. The assignment involved is shown by the %SH[OW] %CCSN command.

LEV

ON

Enable level output. When level output is enabled, %SDUMP %NEST additionally outputs two kinds of levels for each procedure (function or block in C/C++) in the call hierarchy: A general level (counter) with a backward numeration, i.e. from the current procedure to the main procedure. This level number is applicable in the new qualification NESTLEV. A recursive level (RLEV) or an individual counter for each procedure with a backward numeration starting from 0. The recursive level serves as informative element.

OFF

Disable level output.