Explanation
An attempt has been made to start DFSMShsm,
with startup parameters HOST=hostid and HOSTMODE=mode.
The retcode has the following meanings:
- Retcode
- Meaning
- 1
- Another DFSMShsm,
for an earlier release, has already started in this z/OS® image.
- 4
- Another DFSMShsm has
already been started as HOST=hostid in this HSMplex.
- 8
- HOSTMODE is MAIN, and another DFSMShsm host is currently active in the z/OS image with HOSTMODE=MAIN.
- 12
- The data set name of one or more control data sets in the startup
procedure for HOST=hostid is not the same as that
used for already started DFSMShsm host(s).
- 16
- HOSTMODE is AUX, and the attempted method of CDS serialization
does not comply with the following:
- CDSSHR not specified, CDSQ=YES, and MCDS index on a DASD VOLUME
defined as shared
- CDSSHR=YES, CDSQ=YES
- CDSSHR=RLS
- 20
- DFSMShsm support
for JES3 is disabled for a host started with HOSTMODE=AUX.
- 24
- In a MASH environment a DFSMShsm host cannot be started when an
active DFSMShsm host is performing CDS backup on the same LPAR.
System action
DFSMShsm startup ends. Existing DFSMShsm hosts
continue.
Programmer response
- Retcode
- Action
- 1
- If you want to run multiple DFSMShsm hosts in this image, shut down
the earlier version.
- 4
- Choose another value for HOST= that does not appear in the list
of hosts identified by the command QUERY IMAGE, executed for each z/OS image in this HSMplex.
- 8
- Review your intent for this second host and update the HOSTMODE,
if applicable.
- 12
- Update the startup procedure to correct whichever data set names
are incorrect.
- 16
- Update the startup procedure to correct the keyword values for
CDS serialization.
- 20
- The use of JES3 for an AUX host is not supported.
- 24
- Wait for CDS backup to complete on the active DFSMShsm host, then
attempt to start the indicated DFSMShsm host again.