The BCILOGON command is used to establish a session with the desired product region on behalf of the specified user.
The format of the BCILOGON command is:
BCILOGON applname
USER userid ( /password | PASSWORD password )
[ MENU menu ]
[ LUNAME applid | LUPREF luprefix ]
Is the VTAM APPL name of the product region to which you want to connect. This must be the first parameter following the BCILOGON command.
Provides the valid user ID and password combination which will be used for the session. The user ID and password, separated by a slash, can be specified in a single string after the USER keyword (that is, as USER userid/password), or provided separately (that is, as USER userid PASSWORD password). Both the user ID and password must be specified if BCILOGON is run as an ad hoc batch job.
If accessing BCI from another program, the existing user ID and password values for that system (as taken from the UAMS database, or the equivalent security exit procedure) are defaulted for the interface. Logging onto BCI will appear to be transparent, without you having to provide user ID and password, or the ID of the user who submitted the batch job.
The initial menu selection data for the User Services facility. This may contain up to five characters. If present, the characters U.menu are passed to the product region to perform initial menu selection.
If omitted, the User Services procedure defined for the BCI user ID will be selected (this should be $USERBCI in the BCI facility distributed). However, if the user is set up to use the standard $USERSER procedure, a menu option of BCI can be specified.
Specify the entire ACB name (LUNAME applid), or a 1 to 5 character LUNAME prefix (LUPREF luprefix) which the BCI will attempt to open to connect to the product region. If an open fails for any reason, interface processing terminates immediately.
When the LUPREF operand is used, a 3-digit number (nnn) is appended to the LU prefix value. Initially nnn is set to 001 and an attempt to open ACB luprefix001 is performed. If this ACB is in use or varied inactive, the suffix keeps incrementing and the open is retried until an open is successful; or an unrecoverable open error occurs; or the list of defined ACBs is exhausted.
If neither the LUNAME nor LUPREF operand is specified, then an LUPREF of NMBCI is assumed.
Examples: BCILOGON Command
BCILOGON NMCDRSC USER XYZ/XYZ
BCILOGON NMMAIN USER ANET LU ABCINET PASSWORD GO
BCILOGON NMTEST USER OPER LUPREF NMTSO PASSWORD XYZZY
The BCILOGON command may be generated by a user command exit.
Other than the applname parameter which must be the first parameter after the BCILOGON command, subsequent parameters may be entered in any order.