PM78919: COMMANDS USED TO CONTROL AN LT IN WEBSPHERE BI FOR FN FROM A BATCH PROGRAM

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• Sending commands used to control an LT in WebSphere BI for FN is
  only possible within MERVA, from the CMD function. This inhibits
  the remote control of LTs independent of a user who has signed
  on to MERVA.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All MERVA ESA users working with             *
  *                 WebSphere BI for FN.                         *
  ****************************************************************
  * PROBLEM DESCRIPTION: Sending commands used to control an     *
  *                      LT in WebSphere BI for FN is only       *
  *                      possible for a user who has signed on   *
  *                      to MERVA and is using the CMD function. *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  Batch program DWSILCMD sends a single command used to control
  an LT to the WebSphere BI for FN service DNF_ILC_CMD
  and prints the command response. For example, the commands
  LOGIN, SELECT, QUIT, LOGOUT, or QUERY commands. DWSILCMD calls
  the MFS user exit DSLMU004 which in turn calls the non-MERVA
  program DSLDNIC. DSLDNIC is the main program of the Remote
  Login feature.
  This feature actually sends the command from DWSILCMD to the
  DNF_ILC_CMD service and presents the command response from
  DNF_ILC_CMD to DWSILCMD. DWSILCMD retrieves the command
  response from the TOF field DSLCRESP.
  DWSILCMD uses one or two input parameters.
  Parm1
  This is the WebSphere BI for FN command. The keyword DNFILC
  followed by a blank precedes the command. The maximum length of
  the command including keyword and blank is 70 characters.
  This parameter is required.
  Parm2
  This is a MERVA user ID. This parameter is optional. If
  specified DWSILCMD puts it together with the origin ID from
  the associated MERVA user file record to the DSLTUCB control
  block for use by the Remote Login feature. This parameter is
  only required if one of the following conditions is met:
  1. In the Remote Login feature table DSLDNIT, parameter ALTUID
     is omitted or specified with three asterisks.
  2. The command (first parameter) does not contain an LT name.
     That is, -lt or -ltname is omitted.
  If an error occurred, DWSILCMD terminates with return code 8.
  MERVA must be active when DWSILCMD is run.
  

Problem conclusion

Temporary fix

Comments

• This is the JCL to run DWSILCMD.
  
  //........ JOB ........
  //DWSILCMD EXEC PGM=DWSILCMD,REGION=0M,
  // PARM='parm1,parm2'
  //STEPLIB  DD  DSN=MERVA.SDSLLODB,DISP=SHR
  //         DD  DSN=WMQ.SCSQAUTH,DISP=SHR
  //SYSPRINT DD SYSOUT=*
  //SYSUDUMP DD SYSOUT=*
  
  MERVA.SDSLLODB contains the MERVA batch programs.
  WMQ.SCSQAUTH contains the WebSphere MQ programs.
  For running in a batch environment, the Remote Login feature
  program DSLDNIC must be link-edited with the WebSphere
  MQ batch stub CSQBSTUB.
  These are examples how to specify input parameters for DWSILCMD.
  
  //DWSILCMD EXEC PGM=DWSILCMD,REGION=0M,
  // PARM='DNFILC login -lt IBMADEFFA'
  
  A LOGIN command for LT IBMADEFFA is provided. A MERVA user ID is
  not provided.
  
  //DWSILCMD EXEC PGM=DWSILCMD,REGION=0M,
  // PARM='*DNFILC login -lt IBMADEFFA,MAS'
  
  The same LOGIN command and the MERVA user ID MAS are provided.
  An asterisk precedes the keyword DNFILC. Then DWSILCMD prints
  both the input parameter command string and the separated
  parameters (command and user ID).
  

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UK92923

Modules/Macros

• DWSCSD41 DWSEMSC  DWSILCMD DWS1700  DWS1701
  DWS1702  DWS1703  DWS1704  DWS1705  DWS1706  H0B0410J
  

Fix information

• Fixed component name

  MERVA ESA 4.1.0

• Fixed component ID

  5648B2900

Applicable component levels

• R410 PSY UK92923

     UP13/03/28 P F303

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.