Using the Batch Command Interface › BCILOGON Command—Establish Session

BCILOGON Command—Establish Session

The BCILOGON command establishes a session with the desired product region on behalf of the specified user.

This command has the following format:

BCILOGON applname
         USER userid ( /password | PASSWORD password )
       [ MENU menu ]
       [ LUNAME applid | LUPREF luprefix ]

applname

Is the VTAM APPL name of the product region to which you want to connect. This value must be the first parameter following the BCILOGON command.

USER userid { /password | PASSWORD password }

Provides the valid user ID and password combination to use for the session. The user ID and password 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 a batch job on demand.

If accessing BCI from another program, the user ID and password for that system (as taken from the UAMS database or the equivalent security exit procedure) are defaulted for the interface. Logging on to BCI is transparent, without you having to provide user ID and password, or the ID of the user who submitted the batch job.

MENU menu

Specifies the initial menu selection data for the User Services facility. This value can 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 is 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.

LUNAME applid or LUPREF luprefix

Specifies the entire ACB name (LUNAME applid) or a one- through five-character LUNAME prefix (LUPREF luprefix) that the BCI attempts 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 three-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. The open is retried until one of the following conditions occur:

• The open is successful.
• An unrecoverable open error occurs.
• The list of defined ACBs is exhausted.

If you do not specify the LUNAME and LUPREF operands, 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

Note: A user command exit can generate the BCILOGON command.

Other than the applname parameter that must be the first parameter after the BCILOGON command, subsequent parameters can be entered in any order.