Providing the Logon Mode Name to Applications

An application that uses the APPC/MVS callable services can specify a logon mode in its Allocate call. In the following COBOL example, the Mode_name parameter is pre-initialized to MODE01 before the Allocate call is issued.

Figure 1. COBOL example of an ATBALC2 call using a logon mode name

   MOVE "MODE01" TO MODE_NAME.
   CALL "ATBALC2" USING
          CONVERSATION_TYPE,
          SYM_DEST_NAME,
          PARTNER_LU_NAME,
          MODE_NAME,
          ...
          RETURN_CODE.

When a symbolic destination name replaces the need for specifying the logon mode, the logon mode must be named in the side information for that symbolic destination name. In the COBOL example that follows, the symbolic destination name USR3NEWS is used in the CPI Communications Initialize_Conversation (CMINIT) call, which initializes conversations. The symbolic destination name is resolved by its side information in the example box where the logon mode name MODE01 is specified.

Figure 2. COBOL example of a CMINIT call using a symbolic destination name

  MOVE "USR3NEWS" TO SYM_DEST_NAME.
  CALL "CMINIT" USING CONVERSATION_ID,
                      SYM_DEST_NAME,
                      CM_RETCODE.

Figure 3. Side Information for USR3NEWS

  DESTNAME(USR3NEWS)
  MODENAME(MODE01)
  TPNAME(NEWS)
  PARTNER_LU(USER3LU)

For more information about providing a logon mode through an Allocate call or side information, see Specifying a Logon Mode for a Conversation.