Problem: Netex commands do not work on z/OS 1.8
Solution:
After applying this update, Netex commands will work on z/OS 1.8,
and continue to work on earlier levels of z/OS and OS/390.
Right click on the link and save APAR QZA1406 from web.
H210IP Release 6.1 APAR QZA1406 Installation - Mar 12, 2007
This document contains instructions for downloading and installing
APAR QZA1406 for H210IP Release 6.1 (NetEx/IP for z/OS, OS/390).
********************* IMPORTANT NOTICE ***************************
This APAR is required when running Netex/IP on a z/OS Release 1.8
system.
******************************************************************
This APAR is distributed in SMP/E object format. The general
installation steps consist of downloading the APAR file, running
an SMP/E RECEIVE step, followed by running an SMP/E APPLY step.
NetEx/IP must be restarted following this APAR installation in order for
the changes to take effect.
It is recommended that this APAR first be installed into a test NetEx/IP
load library, then subsequently copied into the production NetEx/IP load
library following your internal IT procedures.
Installation Steps
------------------
1) Allocate a dataset on the S/390 system to use for containing the APAR
file.
The dataset should be allocated with the following attributes:
RECFM=FB, LRECL=80, BLKSIZE=3120
2) FTP download the APAR file
The APAR file consists of SMP/E control statements and assembled modules.
After it is downloaded, it will be used to create the subsequent SMPPTFIN
input stream. This file was created using the TSO TRANSMIT command so
that the original file characteristics can be maintained.
The APAR file can be downloaded either directly to the S/390 system (if
internet connectivity exists to that system), or it can be downloaded to
a user PC or workstation, for subsequent uploading to the S/390 system.
Use the following procedure to download the APAR file:
a) ftp ftp.netexsw.com
b) login as anonymous (use your e-mail address as the password)
c) issue the following command to get to the correct directory:
cd /downloads/h21x
d) issue the following command to perform a binary ftp transfer:
binary
e) if FTP'ing directly to S/390, issue the following command to get
the APAR file:
get QZA1406 'dsname' (replace
where 'dsname' specifies the name of the dataset allocated
in step 1. NOTE: be sure to use uppercase for 'QZA'.
f) if FTP'ing to a PC, issue the following command to get
the APAR file:
get QZA1406
NOTE: be sure to use uppercase for 'QZA'.
Then move the QZA1406 file to the S/390 system, to the 'dsname'
dataset allocated in step 1.
3) On the S/390 system, use the TSO RECEIVE command to store the APAR
file in the correct format, so it can be used as the SMPPTFIN input file.
Use the following procedure:
a) Issue the following TSO command to receive the APAR file:
RECEIVE INDSNAME('dsname')
where 'dsname' specifies the name of the dataset allocated
in step 1.
b) The RECEIVE command will issue the following prompt:
ENTER RESTORE PARAMETERS OR 'DELETE' OR 'END'
c) Reply with:
DSN('dsn1')
where 'dsn1' specifies the name of a file the RECEIVE command
will create from the 'dsname' file. The file specified by 'dsn1'
does not need to be pre-allocated. It will be allocated with
the correct attributes so that it can be used as the SMPPTFIN
input file.
Use the NTXSMPE procedure contained on the H210IP Release 6.1 distribution
tape to run the following SMP/E RECEIVE and APPLY installation jobs.
4) RECEIVE the APAR.
Use the following SMP/E control statements as the SYSIN input to the
SMP/E Receive job -
SET BOUNDARY GLOBAL.
RECEIVE LIST SYSMODS.
Direct the SMPPTFIN DD statement in the NTXSMPE proc to point to the
location of the APAR. For example -
//SMPPTFIN DD DSN=index.QZA1406,DISP=SHR
or
//SMPPTFIN DD DSN=NTX.APARS,DISP=(OLD,KEEP),UNIT=TAPE,LABEL=(1,SL),
// VOL=SER=NTXPTF,DCB=(RECFM=FB,LRECL=80,BLKSIZE=800)
Change the value of 'index' to match the high level qualifier used when
the APAR file was created.
5) APPLY the APAR.
Use the following SMP/E control statements as the SYSIN input to the
SMP/E Apply job -
SET BOUNDARY(tgtlib).
APPLY C(ALL) S(QZA1406).
Change the value of 'tgtlib' to match the value specified
when Release 6.1 was installed.
Description of APARs contained in this distribution.
----------------------------------------------------
APAR: QZA1406
-------------
DESCRIPTION: Netex commands do not work on z/OS 1.8
After applying this update, Netex
commands will work on z/OS 1.8, as well
as on earlier levels of z/OS and OS/390.
MACROS AFFECTED: None
MODULES AFFECTED: NXMSSI
REFERENCE:
ENVIRONMENT: z/OS 1.8 and OS/390
Problem: H210IP 6.x - S0C4 abend when running the new 6.1 Configuration Manager (CM) -or- loop when using new PARM format with old JCL.
Solution: Due to a compiler change the PARM for CM has a new format. Example:
// PARM='-N,//DDN:CONFFILE', SPECIFY NCT DDNAME;
There is also new sample JCL on the release tape with changed input & output DD requirements.
Problem: H210IP 6.x - Multiple problems including S0C4 & S0C6 abends - see below for details.
Solution: Apply H210IP Release 6.1 cumulative APARs - Dec 22, 2004
Right-click on the link and save APAR1204 from web.
This document contains instructions for downloading and installing the
Dec 2004 cumulative APARs for H210IP Release 6.1 (NetEx/IP for OS/390).
These APARs are distributed in SMP/E object format. The general
installation steps consist of downloading the accumulative APAR file,
running an SMP/E RECEIVE step, followed by running an SMP/E APPLY step.
NetEx/IP must be restarted following this APAR installation in order for
the changes to take effect.
It is recommended that these APARs first be installed into a test NetEx/IP
load library, then subsequently copied into the production NetEx/IP load
library following your internal IT procedures.
Installation Steps
------------------
1) Allocate a dataset on the S/390 system to use for containing the APAR file.
The dataset should be allocated with the following attributes:
RECFM=FB, LRECL=80, BLKSIZE=3120
2) FTP download the APAR file
The APAR file consists of SMP/E control statements and assembled modules.
After it is downloaded, it will be used to create the subsequent SMPPTFIN
input stream. This file was created using the TSO TRANSMIT command so
that the original file characteristics can be maintained.
The APAR file can be downloaded either directly to the S/390 system (if
internet connectivity exists to that system), or it can be downloaded to
a user PC or workstation, for subsequent uploading to the S/390 system.
Use the following procedure to download the APAR file:
a) ftp ftp.netexsw.com
b) login as anonymous (use your e-mail address as the password)
c) issue the following command to get to the correct directory:
cd /downloads/h21x
d) issue the following command to perform a binary ftp transfer:
binary
e) if FTP'ing directly to S/390, issue the following command to get the
APAR file:
get APAR1204 'dsname' (replace
where 'dsname' specifies the name of the dataset allocated in step 1
f) if FTP'ing to a PC or workstation, issue the following command to get
the APAR file:
get APAR1204
Then move the APAR1204 file to the S/390 system, to the 'dsname' dataset
allocated in step 1.
3) On the S/390 system, use the TSO RECEIVE command to store the APAR
file in the correct format, so it can be used as the SMPPTFIN input file.
Use the following procedure:
a) Issue the following TSO command to receive the APAR file:
RECEIVE INDSNAME('dsname')
where 'dsname' is the same name that was specified in step 2e.
b) The RECEIVE command will issue the following prompt:
ENTER RESTORE PARAMETERS OR 'DELETE' OR 'END'
c) Reply with:
DSN('dsn1')
where 'dsn1' specifies the name of a file the RECEIVE command
will create from the 'dsname' file. The file specified by 'dsn1'
does not neet to be pre-allocated. It will be allocated with
the correct attributes so that it can be used as the SMPPTFIN
input file.
Use the NTXSMPE procedure contained on the H210IP Release 6.1 distribution
tape to run the following SMP/E RECEIVE and APPLY installation jobs.
4) RECEIVE the APARs.
Use the following SMP/E control statements as the SYSIN input to the SMP/E
Receive job -
SET BOUNDARY GLOBAL.
RECEIVE LIST SYSMODS.
Direct the SMPPTFIN DD statement in the NTXSMPE proc to point to the
location of these APARS. For example -
//SMPPTFIN DD DSN=index.APAR1204,DISP=SHR
or
//SMPPTFIN DD DSN=NTX.APARS,DISP=(OLD,KEEP),UNIT=TAPE,LABEL=(1,SL),
// VOL=SER=NTXPTF,DCB=(RECFM=FB,LRECL=80,BLKSIZE=800)
Change the value of 'index' to match the high level qualifier used when
the APAR file was created.
5) APPLY the APARs.
Use the following SMP/E control statements as the SYSIN input to the SMP/E
Apply job -
SET BOUNDARY(tgtlib).
APPLY C(ALL) S(QZA1006,QZA1007,QQZA1009,QZA1010,QZA1011,QZA1012,QZA1013, -
QZA1014,QZA1015,QZA1016,QZA1017).
Change the value of 'tgtlib' to match the value specified when Release 6.1
was installed.
Description of APARs contained in this distribution.
----------------------------------------------------
APAR: QZA1006
-------------
DESCRIPTION: 1) S0C4 IN NXMCNS WHEN WRITING TO NTXLOG FILE
2) INCORRECT DISPLAYS OF MLWTO OUTPUT IN NTXLOG FILE
3) SET MSGXL=ON DOES NOT WORK FOR MLWTO DISPLAYS
MACROS AFFECTED:
MODULES AFFECTED: NXMCNS
REFERENCE:
ENVIRONMENT: OS/390 MVS/ESA
APAR: QZA1007
-------------
DESCRIPTION: RE-ENABLE NAVGAG OPTION FOR NESIGATE DEVICES
MACROS AFFECTED:
MODULES AFFECTED: NXMNAV
REFERENCE:
ENVIRONMENT: OS/390 MVS/ESA
APAR: QZA1009
-------------
DESCRIPTION: IF MAX RATE IS SPECIFIED FOR TYPE 2 PROTOCOL,
DO NOT USE IT FOR CALCULATING BANDWIDTH CAPACITY
MACROS AFFECTED:
MODULES AFFECTED: NXMT2D
REFERENCE:
ENVIRONMENT: OS/390 MVS/ESA
APAR: QZA1010
-------------
DESCRIPTION: WAIT BEFORE REDRIVING 10FE I/O COMPLETIONS (CC3)
MACROS AFFECTED:
MODULES AFFECTED: NXMD1W NXMRDR
REFERENCE:
ENVIRONMENT: OS/390 MVS/ESA
APAR: QZA1011
-------------
DESCRIPTION: S0C4 IN NXMD1W WHEN ATTEMPTING CONNECTION AND
ALL DEVICES ARE OFFLINE
MACROS AFFECTED:
MODULES AFFECTED: NXMD1W
REFERENCE:
ENVIRONMENT: OS/390 MVS/ESA
APAR: QZA1012
-------------
DESCRIPTION: THIS APAR CORRECTS TWO PROBLEMS
1) HALTED ADAPTER IN PATH IS NOT BYPASSED IN PATH
SELECTION
2) S0C6 ABEND MAY OCCUR IN NXMT2D DUE TO BASE REGISTER
CORRUPTION
MACROS AFFECTED:
MODULES AFFECTED: NXMN2A NXMN2C NXMT2D
REFERENCE:
ENVIRONMENT: OS/390 MVS/ESA
APAR: QZA1013
-------------
DESCRIPTION: WAIT BEFORE REDRIVING '8200' SENSE BYTE UNIT CHECKS
MACROS AFFECTED:
MODULES AFFECTED: NXMD1W NXMRDR
REFERENCE:
ENVIRONMENT: OS/390 MVS/ESA
APAR: QZA1014
-------------
DESCRIPTION: WHEN RUNNING LOTS OF CONSECUTIVE SESSIONS OF VERY SHORT
DURATION, AND USING SCLOSE (E.G. CLOSE PARAMETER IS
SPECIFIED IN BFX TRANSFERS), IT IS VERY LIKELY THAT FALSE
3512 NRBSTAT RETURN CODES MAY BE GENERATED. THIS IS BECAUSE
THE TOTAL NUMBER OF SUB, TUB, AND NUB CONTROL BLOCKS WAS BEING
CHECKED WHEN COMPARING WITH THE TOTAL NUMBER OF CONNECTIONS
ALLOWED. WHEN 'CLOSE' IS USED, TRANSPORT AND NETWORK CONNECTIONS
STAY CONNECTED SOMEWHAT LONGER THAN THE SESSION CONNECTIONS, IN
ORDER TO BETTER ENSURE THAT THE SCLOSE AND ALL REMAINING ACKS
ARE GENERATED AND RECEIVED PROPERLY.
THIS FIX REMOVES THE TUB AND NUB CONTROL BLOCKS FROM THE SESMAX
CALCULATION, SO THAT THE ONLY TIME SESMAX WILL BE CHECKED IS
WHEN A SESSION USER BLOCK IS CREATED.
MACROS AFFECTED:
MODULES AFFECTED: NXMUBM NXMT2O
REFERENCE:
ENVIRONMENT: OS/390 MVS/ESA
APAR: QZA1015
-------------
DESCRIPTION: LOOPING SP1KQ MEMORY ALLOCATION FOR NETWRDR WHEN USING PROTOCOL 4.
MACROS AFFECTED:
MODULES AFFECTED: NXMT2D
REFERENCE:
ENVIRONMENT: OS/390 MVS/ESA
APAR: QZA1016
-------------
DESCRIPTION: AFTER ISSUING AN SCLOSE MACRO, IF THE APPLICATION DOES NOT READ THE
SUBSEQUENT RECEIVED CLOSE WITHIN A 'DEADTO' INTERVAL, THEN INTERNALLY
GENERATE A DISCONNECT TO TERMINATE THE CONNECTION. DO NOT ISSUE ANY
'COMMUNICATIONS INTERRUPTED' OR 'COMMUNICATIONS LOST' MESSAGES, AND
DO NOT ATTEMPT A PATH SWITCH (APR).
MACROS AFFECTED:
MODULES AFFECTED: NXMUBM NXMT2O NXMSRD NXMERT
REFERENCE:
ENVIRONMENT: OS/390 MVS/ESA
APAR: QZA1017
-------------
DESCRIPTION: UPDATE SERVICE LEVEL TO 1204.
MACROS AFFECTED: NTCLVL
MODULES AFFECTED: NXMLVL
REFERENCE:
ENVIRONMENT: OS/390 MVS/ESA