SoftSpy identifiers
Introduction
SoftSpy identifiers are used to specify four types of objects in SoftSpy commands and macros.
The table below lists the types of SoftSpy identifiers.
| Identifier | Identifies... |
|---|---|
| access_control_list_identifier | an access control list |
| label_identifier | a macro label |
| macro_identifier | a macro |
| window_identifier | a window |
access_control_list_identifier
Function
Identify an access control list.
Syntax
Description
An access_control_list_identifier is used to identify an access control list. Access_control_list_identifiers begin with an alphabetic character that is optionally followed by one or more alphabetic, numeric, or underscore characters. The maximum allowed length is twenty characters.
Examples
ADMIN
See Also
BROWSE ACL, COPY ACL, DELETE ACL, EDIT ACL, EDIT CONFIG, LIST ACL, PRINT ACL, PRINT LIST, RENAME ACL, SAVE ACL
label_identifier
Function
Identify a macro label.
Syntax
Description
A label_identifier identifies a line within a macro. Label_identifiers begin with an alphabetic character that is optionally followed by one or more alphabetic, numeric, or underscore characters. The maximum allowed length is twenty characters.
Labels in macros consist of a label_identifier followed by a colon. A label can be on a line by itself or can be followed by a command.
Examples
MAIN_LOOP: JUMP TO MAIN_LOOP CHECK: IF $SUBSYS EQ 'SSTEST' THEN JUMP TO SKIP
See Also
JUMP TO
macro_identifier
Function
Identify a macro.
Syntax
Description
A macro_identifier is used to identify a macro. Macro_identifiers begin with an alphabetic character that is optionally followed by one or more alphabetic, numeric, or underscore characters. The maximum allowed length is twenty characters.
If a macro_identifier begins with your userid followed by an underscore then it identifies a user macro. Otherwise the macro_identifier identifies a system macro.
Examples
PROFILE OLD_PROFILE QQUIT
See Also
BROWSE MACRO, COPY MACRO, DELETE MACRO, EDIT MACRO, EXEC, LIST MACRO, PRINT LIST, PRINT MACRO, RENAME MACRO, SAVE MACRO
window_identifier
Function
Identify a window.
Syntax
Description
A window_identifier identifies a window. Window_identifiers begin with an alphabetic character that is optionally followed by one or more alphabetic, numeric, or underscore characters. The maximum allowed length is twenty characters.
SoftSpy has certain built-in window names, which are summarized in the following table:
| Window | Contains... |
|---|---|
| BROWSE | The access control list or macro being browsed in the BROWSE context. |
| CONFIG | SoftSpy configuration information in the CONFIG context. |
| EDIT | The access control list or macro being edited in the EDIT context. |
| HELP | On-line help in the HELP context. |
| LIST | A list of access control lists or macros in the LIST context. |
| SOURCE | The current User Language request in the COMPILE_ERROR and EVAL contexts. |
Examples
SOURCE MONITOR STATS_AND_GLOBALS
See Also
ACTIVE WINDOW, CLOSE WINDOW, DEFINE WINDOW, DELETE WINDOW, IN WINDOW, OPEN WINDOW, PRINT WINDOW