CESN - sign on

Use CESN to sign on to CICS® by using a user ID and a password or a similar authenticator.

The CESN transaction can be used as a 3270 transaction from a 3270 terminal or as a single-line command from both 3270 and non-3270 devices. This section describes the 3270 transaction. For information about the line command, see Sign on - non-3270 family terminal.

The CESN sign-on transaction displays a BMS map. The transaction is pseudo-conversational and uses the EXEC CICS SIGNON command. For details of the parameters on the BMS map, see SIGNON.
Figure 1. CESN transaction: initial screen
                           Signon to CICS                              APPLID DBDCCICS

 . . . . . . This is where the "good morning" message appears. . . . . . .
 . . . . . . It can be up to four lines in depth to contain the. . . . .
 . . . . . . maximum message length of 246 characters (that is, three. .
 . . . . . . full lines and six characters on the fourth line) . . . . .


 Type your userid and password, then press ENTER:

          Userid . . . . ________    Groupid . . . ________

          Password . . . ________

          Language . . . ___

      New Password . . . ________


 DFHCE3520 Please type your userid.
 F3=Exit
The panel for screens sized 40 x12 is shown below. There is no space on these screens for the release number or the “good morning” message.
Figure 2. CESN transaction: 40 x 12 screen
                           Signon to CICS                              APPLID DBDCCICS

             Userid   . . . . ________
             Groupid  . . . . ________
             Password . . . . ________
             Language . . . . ___
             New Password . . ________


 DFHCE3520 Please type your userid.
 F3=Exit
Notes:
  1. If a user signs on at a terminal that is already signed on, CESN signs off the previous user. However, it does not happen unless the user completes the CESN panel before pressing ENTER.
  2. For mixed case passwords to be supported, ensure that the PROFILE for the sign-on transaction CESN specifies UCTRAN(NO). This is the value for the CICS-supplied definitions. Otherwise, passwords that are specified in the CESN transaction are converted to uppercase.
  3. If support for mixed case passwords is in use, CICS saves the value of the UCTRAN option for the terminal and temporarily sets it to UCTRAN(NO) while the user is prompted to enter credentials. The user ID and other parameters are always translated into uppercase but the password remains in the case entered by the user. When the CESN transaction completes, the UCTRAN attribute is restored to its original value. If the user disconnects from the terminal before the transaction is completed, the terminal might be left with the UCTRAN(NO) attribute set.
  4. If the old password expires, this dialog prompts for a new password. The password can also be changed before it expires.
  5. Autoinstall of BMS maps is not carried out within the CESN transaction. When CESN tries to send out any BMS map that is not installed, CESN sends out the English BMS map.
  6. You can customize the CESN map set only if you do not change the format of the symbolic map set. The source for the CESN map is included in map set DFHSNLE in the SDFHSAMP library. After customization, regenerate the physical map sets in the usual way into a load library, which must be included in your DFHRPL concatenation in front of the CICS libraries. For more information, see Basic mapping support.
  7. Unsuccessful sign-on and sign-off errors cause DFHCEnnnn messages to be issued.
  8. RACF OIDCARD users can use CESN to sign on if the card reader supports the DFHOPID attention identifier (AID). If it does not, you will need to write your own sign-on program using the EXEC CICS SIGNON command. For programming information, see SIGNON.