SIGNON Statement

The SIGNON statement permits users to identify themselves to the compiler and to describe the environment in which the compiler is to execute.
idms19
The SIGNON statement permits users to identify themselves to the compiler and to describe the environment in which the compiler is to execute.
This article describes the following information:
2
2
Authorization
If IDMS SECURITY is ON in the dictionary, you must already be assigned the appropriate authority (IDMS, SCHEMA, or SUBSCHEMA) through the AUTHORITY clause of the IDD DDDL USER statement.
For more information on the DDDL USER statement, see IDD DDDL Reference.
Syntax
►►─── 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 compiler. If the SECURITY clause of the dictionary (DDDL) SET OPTIONS statement specifies that security for IDMS is on,
    user-id
    must be the ID of a user authorized (in the DDDL USER clause) for schema or subschema 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 compiler.
  • DICtionary name is
    dictionary-name
    Specifies the dictionary to be accessed by the 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 compiler can access dictionary areas. This clause overrides the usage mode defined during system generation by means of the IDD statement (see Administrating Security for IDMS).
  • UPDate
    Specifies that the current user and all other users can update the dictionary concurrently. The 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.
  • 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 IDMS 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 SCHEMA or SUBSCHEMA 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.
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
  • Session attributes as established by DCUF, SYSIDMS, system or user profiles
  • The default dictionary associated with the local runtime environment.
User ID Used in Subsequent DDL Statements
User-id
becomes the value assigned in the PREPARED BY and REVISED BY clauses (
user-specification
clause) in subsequent DDL statements, replacing any user named during system signon; this value can be overridden with the SET OPTIONS statement, described in this section.
More Information: