OA63701: NEW FUNCTION - z/OS DFSMShsm V2R4 and above has been modified tosupport SYSNAME and HSMSYM keywords on the ONLYIF command.

APAR status

• Closed as new function.

Error description

• New Function
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All DFSMShsm users on v2r4 and higher.                       *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * New Function: DFSMShsm support of                            *
  * SYSNAME and HSMSYM keywords on the                           *
  * ONLYIF command.                                              *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  

Problem conclusion

• New Function: DFSMShsm has been updated to support the use of
  SYSNAME and HSMSYM keywords on the ONLYIF command.
  
  Publication changes for OA63701
  The updates will be reflected in a future revision of the
  following publication:
  
  z/OS DFSMShsm Storage Administration (SC23-6871)
  z/OS MVS System Messages, Vol 2 (ARC-ASA) (SA38-0669)
  
  Changes for z/OS DFSMShsm Storage
  Administration SC23-6871-50
  
  ONLYIF command: Running commands in ARCCMDxx
  conditionally
  
  <<After first paragraph add>>:
  The following examples apply to all supported keywords on
  the ONLYIF statement. This includes HSMHOST,
  SYSNAME and HSMSYM
  
  Syntax of the ONLYIF command
  <<Update diagram>>
  
  
  ONLYIF_ ____________________________ _ new_line_>
       |            <_,___<         |
       |___HSMHOST(_hostid_|_)______|
       |                            |
       |             __*ALL*__      |
       |___SYSNAME_(|_sysname_|_)___|
       |                            |
       |___HSMSYM_(_value1 value2_)_|
  
  
    >_ ______________________command__________ _____>
      |                                       |
      |              <__new_line__<           |
      |              |            |           |
      |__BEGIN__nl __|__command___|__nl__END__|
  
  
  Required parameters of the ONLYIF command
  <<Add links>>
  SYSNAME: Specifies the system name where the next line should
           be processed.
  
  HSMSYM: Specifies the HSM system symbol and its value where
           the next line should be processed.
  
  <<After HSMHOST required parameter description add new
  sections for SYSNAME and HSMSYM>>
  
  SYSNAME: Specifies the system name where the next line should
           be processed.
  
  Explanation
  
  Specifies the system name on which the command on the next
  line, or a BEGIN ... END block, should be run, if the system HSM
  is initialized on matches this system name. Valid values are
  1-8 character names or the reserved string *ALL*. The system
  name is defined by the SYSNAME parameter in the
  IEASYMxx or IEASYSxx PARMLIB members.
  
  Defaults
  If the keyword is not specified or *ALL* is specified, the
  next line is processed on all systems.
  
  
  HSMSYM: Specifies the HSM system symbol and its value where
           the next line should be processed.
  
  Explanation
  
  This keyword is used to perform a comparison of a user defined
  system symbol, value1, and its current value to the literal
  value2 specification.
  
             value1, value2
  
  These values specify the system symbol and the literal value
  that is checked to match the current value set in the system
  for this symbol. The command on the next line, or a BEGIN...END
  block, should be run if the literal value for this keyword
  matches the system setting for it. The system symbol must
  be between 1-44 characters long. The values must adhere to
  standard system symbolic syntax rules for defining static
  system symbols. The system symbol and its current value
  is defined by the SYSDEF SYMDEF command of the IEASYMxx
  parmlib member.
  
  
  Defaults
  None.
  
  Examples of how to code the ONLYIF command
  <<After first paragraph add>>:
  
  The following examples apply to all supported keywords on the
  ONLYIF statement. This includes HSMHOST, SYSNAME and HSMSYM
  
  <<Add the following example>>
  
  Specifying a different HSMPLEXNAME in an HSM configuration for
  a production system and a disaster recovery exercise system
  that both share the same SYSNAME and the same DFSMShsm parmlib
  member.
  ONLYIF HSMSYM(&HSMSYS PROD)
  BEGIN
      SETSYS HSMPLEXNAME(PROD)
  END
  ONLYIF HSMSYM(&HSMSYS DR)
      SETSYS HSMPLEXNAME(DR)
  
  In this example, an HSM system symbol HSMSYS is set to PROD on
  the production system and DR for the disaster recovery system.
  These system symbols are defined by statements in the IEASYMxx
  parmlib. When DFSMShsm is started on the production system,
  the HSMSYS symbol resolves to PROD which matches its second
  literal value of PROD on the first ONLYIF HSMSYM command.
  In this case, the ONLYIF evaluates to be true and the
  subsequent statement is executed. Additional statements between
  the BEGIN/END keywords can be added to conditionally be run.
  The second ONLYIF HSMSYM evaluates not to be true since it is
  looking for a value of DR and the subsequent statement, and
  only that statement, is skipped.
  
  
  Changes for z/OS MVS System Messages, Vol 2 (ARC-ASA)(SA38-0669)
  
  ARC1605I   COMMAND HAD PARSE ERROR
  <<Change description of return code 40 to include
  SYSNAME, HSMSYM required parameters and their values>>
  
  40 - An ONLYIF command failed for one or more of the
  following reasons:
  * A parse error occurred while trying to parse the command.
  * The required parameter, HSMHOST, SYSNAME or HSMSYM
  was not specified.
  * The required host ID value, system name value, or the hsm
  symbol value(s) was not specified.
  * An ONLYIF command was nested within another ONLYIF command.
  

Temporary fix

Comments

• To enable this support, you must install the appropriate PTF
  for this APAR OA63701 along with all other PTFs required during
  the installation of OA63701 PTF.
  

APAR Information

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

  OA63678

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

  UJ92437 UJ92438

Modules/Macros

• ARCRDIN
  

Fix information

• Fixed component name

  DFSMSHSM, ISMF

• Fixed component ID

  5695DF170

Applicable component levels

• R250 PSY UJ92438

     UP23/04/14 P F304  

• R240 PSY UJ92437

     UP23/04/14 P F304