PTF Cover Letter
PTF ( Program Temporary Fixes ) Cover letter
OSP-OTHER Configure host server subsystems by user
Pre/Co-Requisite PTF / Fix List
REQ LICENSED PTF/FIX LEVEL
TYPE PROGRAM RELEASE NUMBER MIN/MAX OPTION
---- -------- --------- ------- ------- ------
PRE 5770SS1 V7R3M0 SI59659 00/00 0000
Application of this PTF may disable or render ineffective programs that
use system memory addresses not generated by the IBM translator,
including programs that circumvent control technology designed to limit
interactive capacity to purchased levels. This PTF may be a prerequisite
for future PTFs. By applying this PTF you authorize and agree to the
This PTF is subject to the terms of the license agreement which
accompanied, or was contained in, the Program for which you are obtaining
the PTF. You are not authorized to install or use the PTF except as part
of a Program for which you have a valid Proof of Entitlement.
SUBJECT TO ANY WARRANTIES WHICH CAN NOT BE EXCLUDED OR EXCEPT AS EXPLICITLY
AGREED TO IN THE APPLICABLE LICENSE AGREEMENT OR AN APPLICABLE SUPPORT
AGREEMENT, IBM MAKES NO WARRANTIES OR CONDITIONS EITHER EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OR CONDITIONS OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON INFRINGEMENT,
REGARDING THE PTF.
The applicable license agreement may have been provided to you in printed
form and/or may be viewed using the Work with Software Agreements (WRKSFWAGR)
APAR Error Description / Circumvention
Connections for the data queue server, central server, network
print server, and file server host servers can be run in the
default subsystem or can be configured to run in a specific
subsystem by using the client TCP/IP address.
Users would like the ability to configure these server
connections by user profile, group profile, or a group in the
supplemental group list.
Additionally, users would like the option for the connection to
fail if the user configured subsystem is not active.
CORRECTION FOR APAR 'SE64267' :
The PTF provides the support for the data queue server, central
server, network print server, and file server host servers to
service a connection for a user, group or supplemental group
profile in the subsystem as configured using the
SET_SERVER_SBS_ROUTING SQL procedure. The profiles will be
checked in order of user profile, group, supplemental group list
as defined in the user profile and the first subsystem routing
configured will be used.
A new optional parameter, ALLOW_ROLLOVER, has been added to the
SET_SERVER_SBS_ROUTING SQL procedure. When this new parameter
is set to NO, the connection will fail when the target subsystem
cannot be used.
See the special instructions for using this new support.
CIRCUMVENTION FOR APAR 'SE64267' :
If applying the PTF immediately, please follow these instructions:
Prior to applying the PTF, issue the ENDHOSTSVR SERVER(*ALL) command
to end all of the host servers. Use the ENDSBS SBS(QSERVER) command
to end the QSERVER subsystem. As shipped, the prestarted jobs for
several of the servers run in the QUSRWRK subsystem. This may have
been customized by your system administrator, however, thus allowing
the prestarted jobs to run in other subsystems. Use the ENDSBS
command to end all of the subsystems which contain jobs with the
QNPSERVS, QZDASOINIT, QZDASSINIT, QZHQSSRV, QZRCSRVS, QZSCSRVS,
Ensure these subsystems have ended, using the Work with Subsystems
(WRKSBS) command, before applying the PTF. Additionally, if the
QIWVPPJT job is running in the QSYSWRK subsystem, it should be
ended with the following command:
QSYS/ENDPJ SBS(QSYSWRK) PGM(QIWS/QIWVPPJT) OPTION(*IMMED)
After applying the PTF, use the STRSBS command to start all of the
subsystems that were ended prior to applying the PTF. Start the
QIWVPPJT job, if it had been previously ended, using the following
QSYS/STRPJ SBS(QSYSWRK) PGM(QIWS/QIWVPPJT)
Issue the STRHOSTSVR SERVER(*ALL) command to start the host servers.
This PTF provides support for the data queue server (QZHQSSRV), central
server (QZSCSRVS), network print server (QNPSERVS), and file server
(QPWFSERVSO) host servers to service connections in subsystems for
a user or group profile when configured using the
SQL procedure. In addition to using the SQL procedure to configure the
subsystem for the user, group or supplemental group profile, the
specified subsystem must be created and started.
In order to use this support a subsystem description and other related
objects must be created as well as using the SET_SERVER_SBS_ROUTING
procedure to set the subsystem for the user. The following steps
create the needed objects in library SBSLIB. See the help text for
each command for additional information.
1. Create the subsystem using the Create Subsystem Description
CRTSBSD SBSD(SBSLIB/MYSBS) POOLS((1 *BASE))
TEXT('Custom Server Subsystem')
2. Create a class for performance characteristics using the Create
CRTCLS SBSLIB/MYSBS RUNPTY(20) TIMESLICE(2000) DFTWAIT(30)
TEXT('Custom Subsystem Class')
3. Create a job queue for the subsystem and add a job queue entry using
the Create Job Queue (CRTJOBQ) and Add Job Queue Entry (ADDJOBQE)
ADDJOBQE SBSD(SBSLIB/MYSBS) JOBQ(SBSLIB/MYSBS) MAXACT(*NOMAX)
4. Add a routing entry to the subsystem using the Add Routing Entry
(ADDRTGE) command. The following example adds a generic routing
entry. Consider adding other routing entries similar to those
defined on QUSRWRK subsystem.
ADDRTGE SBSD(SBSLIB/MYSBS) SEQNBR(9999) CMPVAL(*ANY)
5. Add a prestart job entry to the subsystem for each server you wish
to be routed to the subsystem. An example for each of the servers
supported by this PTF is below.
Data queue server:
ADDPJE SBSD(SBSLIB/MYSBS) PGM(QSYS/QZHQSSRV) INLJOBS(1)
THRESHOLD(1) JOB(QZHQSSRV) JOBD(QSYS/QZBSJOBD) MAXUSE(200)
ADDPJE SBSD(SBSLIB/MYSBS) PGM(QSYS/QZSCSRVS) INLJOBS(1)
THRESHOLD(1) JOB(QZSCSRVS) JOBD(QSYS/QZBSJOBD) MAXUSE(200)
Network print server:
ADDPJE SBSD(SBSLIB/MYSBS) PGM(QSYS/QNPSERVS) INLJOBS(1)
THRESHOLD(1) JOB(QNPSERVS) JOBD(QSYS/QZBSJOBD) MAXUSE(200)
ADDPJE SBSD(SBSLIB/MYSBS) PGM(QSYS/QPWFSERVSO) INLJOBS(1)
THRESHOLD(1) JOB(QPWFSERVSO) JOBD(QSYS/QPWFSPJ)
6. Start the subsystem using the Start Subsystem (STRSBS) command.
7. Configure user MYUSER to use this new subsystem for remote command
server connections using the SQL procedure. Specify the user,
group, or supplemental group profile as appropriate.
THIS PTF CAN BE APPLIED IMMEDIATE OR DELAYED.
PTF/FIX NO(S). APAR TITLE LINE
|APAR Fixed..........................||View details for APAR SE64267|
|Superseded by:......................||View fix details for PTF SI65263|
|MRI Feature ........................||NONE|
07 April 2016