Adjust parameters to start IOSHMCTL in TPC-R Basic Hyperswap environment

Description

With APAR OA40866 applied (with one of the following PTFs: UA71220 for z/OS V2R1, or UA71219 for z/OS V1R13), parameters supplied in the JCL to start PGM=IOSHMCTL may be rejected. APAR OA40866 introduced new function which caused JCL parameter checking to now be enforced. As a result, unsupported parameters will be rejected and IOSHMCTL will not start due to JCL failures.

For example:

ASA101I SYNTAX ERROR: MODE=EXT, WAS SEEN, WHERE ONE OF 
(SOCKPORT=) 
WOULD BE CORRECT. 
DETECTING MODULE IS IOSHMCTL

Prior to APAR OA40866, unsupported parameters would be ignored and IOSHMCTL would start without any JCL failures.

Note: This problem is a documentation error where some examples of JCL to start the Basic HyperSwap address space used incorrect parameters. At this time with Basic HyperSwap Sockets Server APAR OA40866 applied, the only parameter allowed to the IOSHMCTL program is 'SOCKPORT=port_num'. Any other parameters are rejected.

Table 1 provides more details about the migration action. Use this information to plan your changes to the system.

Table 1. Information about this migration action
Element or feature:	BCP.
When change was introduced:	z/OS V2R1 and z/OS V1R13, both with APAR OA40866 applied.
Applies to migration from:	z/OS V2R1 and z/OS V1R13, both without APAR OA40866 applied.
Timing:	Before the first IPL of z/OS V2R2.
Is the migration action required?	Yes, if you have unsupported parameters specified to start the Basic HyperSwap address space.
Target system hardware requirements:	None.
Target system software requirements:	None.
Other system (coexistence or fallback) requirements:	None.
Restrictions:	None.
System impacts:	None.
Related IBM® Health Checker for z/OS® check:	None.

Steps to take

Follow these steps:

When applying the PTF for APAR OA40866, make sure that any HSIB procedures to start IOSHMCTL do not include unsupported parameters. For example, the following JCL may be used:
```
//HSIB JOB MSGLEVEL=(1,1),TIME=NOLIMIT,REGION=0M 
//IEFPROC EXEC PGM=IOSHMCTL
```

Tip: Some older publications, including Redpapers, might have documented incorrect parameters on the PARM statement used in the examples of suggested procedures for starting IOSHMCTL. It is best to refer to the latest TPC-R publications for current supported parameters.

Reference information

For more information, see APAR OA46189, which describes the potential JCL failures after installing PTFs for APAR OA40866.