Safeguard Management Programming Manual (G06.29+, H06.08+, J06.03+)

Common Definitions
Safeguard Management Programming Manual—422086-028
6-6
Safeguard-Specific Standard Definitions
Safeguard-Specific Standard Definitions
Definition names beginning with ZSFG- are Safeguard definitions. These definitions
consist of simple tokens and extensible structured tokens used in Safeguard
commands and responses. These definitions are available to all Safeguard
management applications and are located in the ZSPIDEF.ZSFGDDL definition files.
For more information, see Definition Files on page 3-2. For information about a
particular command or response given, see Section 7, Commands.
Appendix A, Error Numbers and Error Lists, lists Safeguard error numbers and the
definitions used in error lists.
Selection Expressions
Selection expressions are used to list users or alias or groups based on the operands
or the specified expression.
The following selection expressions are described in this section:
•
SAFECOM WHERE CREATION-TIME selection options
•
SAFECOM WHERE GROUP selection options
SAFECOM WHERE CREATION-TIME selection options
The SAFECOM WHERE CREATION-TIME selection options can be used in the INFO
command buffer to select users or aliases based on their creation time.
The general procedure for using these options is to specify ZSPI-TKN-SEL-OPERAND
tokens to build an array of operands. This value can be one of the following tokens:
•
ZSFG-TKN-CREATION-TIME
•
ZSPI-TKN-SEL-CONSTANT
Typically, the operand array used in a WHERE CREATION-TIME expression contains
CREATION-TIME and ZSPI-TKN-SEL-EXPRESSION tokens, and a constant that
represents CREATION-TIME. Such an array allows you to specify that a user or an
alias must belong to one or a combination of the groups whose creation time is
specified by the constants in the array. A minimum of two operands is required to
perform a simple comparison. For example, a simple comparison that selects all users
who were created on 2 JAN 2000, 23:26 has two operands: ZSFG-TKN-CREATION-
TIME one ZSPI-TKN-SEL-CONSTANT. The constant contains the timestamp details as
2 JAN 2000, 23:26.
When the operand array is defined, the ZSPI-TKN-SEL-EXPRESSION token enables
you to compare operands selected from the array using the ZSPI-VAL-SELOP-EQUAL,
ZSPI-VAL-SELOP-LESS, and ZSPI-VAL-SELOP-GREATER tokens after the ZSFG-
TKN-CREATION-TIME token. In addition, you can combine the results of the