SIGNON Statement (DDDL)

The SIGNON statement permits users to identify themselves to the DDDL compiler and to describe the environment in which the compiler is to execute.
idmscu19
The SIGNON statement permits users to identify themselves to the DDDL compiler and to describe the environment in which the compiler is to execute.
If IDD SECURITY is ON in the dictionary, you must already be assigned the IDD authority through the AUTHORITY clause of the USER statement (see USER).
You can also prevent unauthorized access to the dictionary using the central security facility. For information on the central security facility, see the "Administrating Security for IDMS" section of the CA IDMS documentation.
Syntax
SIGNON Statement
►►─── SIGnon ─────────────────────────────────────────────────────────────────► ►─┬───────────────────────────────────────────────────────────────────┬──────► └─ USEr name ─┬─ is ─┬─
user-id
─┬────────────────────────────────┬─┘ └─ = ──┘ └─ PASsword ─┬─ is ─┬─
password
─┘ └─ = ──┘ ►─┬──────────────────────────────────────────────────────┬───────────────────► └─┬─ DICtionary name ─┬─┬─ is ─┬─┬─
dictionary-name
─┬─┘ ├─ DICTName ─┬──────┘ └─ = ──┘ └─ ' ' ─────────────┘ └─ DBName ───┘ ►─┬─────────────────────────────────────────┬────────────────────────────────► └─┬─ NODe name ─┬─┬─ is ─┬─┬─
nodename
─┬─┘ └─ NODEName ──┘ └─ = ──┘ └─ ' ' ──────┘ ►─┬───────────────────────────────────────────────────────────────────┬──────►◄ └─ USAge mode ─┬─ is ─┬─┬─ UPDate ───────────┬─ for ─┬─ ALL ◄ ────┬─┘ └─ = ──┘ ├─ PROtected UPDate ─┤ ├─ DDLDML ───┤ └─ RETrieval ────────┘ ├─ DDLDCLOD ─┤ └─ DDLDCMSG ─┘
Parameters
  • USEr name is
    user-id
    Specifies the ID of the user signing on to the DDDL compiler. If the SECURITY clause of the SET OPTIONS statement specifies that security for IDD is on,
    user-id
    must be the ID of a user authorized (in the USER clause) for DDDL compiler access.
    User-id
    must be a 1- to 32-character value and must be enclosed in quotation marks if it contains embedded blanks or delimiters.
  • PASsword is
    password
    Specifies the password of the user signing on to the DDDL compiler.
  • DICtionary name is
    dictionary-name
    Specifies the dictionary to be accessed by the DDDL compiler. If
    dictionary-name
    is blanks enclosed by quotes, it indicates the default dictionary for the local mode runtime environment or the target node if running under the central version.
  • NODe name is
    nodename
    Specifies the name of the node that controls the dictionary to be accessed.
    Nodename
    identifies a node in the network. If
    nodename
    is blanks enclosed in quotes, it indicates the local node (the node at which the online compiler is executing or the DC/UCF system accessed by the batch compiler running under the central version).
  • USAge mode is
    Specifies the manner in which the DDDL compiler can access dictionary areas. This clause overrides the usage mode defined during system generation by means of the IDD statement (see
    CA IDMS Administrating section
    ).
  • UPDate
    Specifies that the current user and all other users can update the dictionary concurrently. The DDDL compiler automatically prevents deadlock conditions or situations in which users must wait for commands issued by other users to be processed. This is the default, unless overridden during system generation, and is also the suggested usage mode for the DDDL compiler.
  • PROtected UPDate
    Specifies that only the current user can update the dictionary. Other users are restricted to performing retrieval operations. During an online session, the current user has exclusive control for update only if the DDDL compiler has been invoked. Between terminal interactions, the areas can be updated by other users.
  • RETrieval
    Specifies that the current user can only perform retrieval operations against the dictionary. This usage mode does not restrict other users from accessing the dictionary in update or protected update mode.
  • FOR ALL
    Indicates that the usage mode applies to all areas. ALL is the default.
  • FOR DDLDML
    Indicates that the usage mode applies only to the DDLDML area.
  • FOR DDLDCLOD
    Indicates that the usage mode applies only to the DDLDCLOD area.
  • FOR DDLDCMSG
    Indicates that the usage mode applies only to the DDLDCMSG area.
Usage
When to specify USER and PASSWORD in SIGNON
If
you are identified to the environment in which the compiler is executing and you do not hold the necessary authorities to perform the intended actions
, you must use the USER clause of SIGNON. In this case, you would specify the ID of a user who holds the necessary authorities (providing USER SIGNON OVERRIDE IS ALLOWED is specified in the SET OPTIONS statement). If the user ID you specify has been assigned a password in the dictionary being accessed, you must also supply that password in the SIGNON statement.
If
you are not identified to the execution environment and IDD SECURITY is ON
, you must use the USER parameter of SIGNON. In this case, the user ID and password you specify are verified by the central security facility. If verified, you will be known to both the execution environment and the compiler. The user ID must hold the appropriate IDD authority in the dictionary you are accessing as well as the authority to sign on to the DC/UCF system (if you are executing online). If the user ID you specify has been assigned a password in the central security facility, that password must be specified in the SIGNON statement.
In all other cases, the USER parameter is not required and should not be specified.
For more information on the central security facility, refer to the "Administrating Security for IDMS" section of the CA IDMS documentation.
Identifying the dictionary to be accessed
The DICTIONARY and NODENAME clauses together identify the dictionary to be accessed by the compiler. If only one is specified, the other is derived.
Dictionary-name
, if specified, must identify a DBNAME or segment accessible at the target node or local mode runtime environment. If
dictionary-name
is not specified, but
nodename
is specified, then the dictionary is the default dictionary at the specified node.
In local mode,
nodename
has no meaning and is ignored. When running under the central version,
nodename
, if specified, identifies the node at which the target dictionary resides. If not specified, the location of the dictionary is determined from the resource table associated with the local DC/UCF system.
If neither
dictionary-name
nor
nodename
is specified, they will be established from:
  • The TCF specification, if running under TCF (for more information, refer to
    CA IDMS Common Administrating section
    )
  • Session attributes as established by DCUF, SYSIDMS, system or user profiles
  • The default dictionary associated with the local runtime environment
Readying several areas
The USAGE MODE clause can be repeated to ready different areas in different usage modes. For example, to add or delete a load module from an area on a system in which the DDLDML area is available for retrieval only, specify USAGE MODE IS RETRIEVAL FOR DDLDML.