IBM Support

SI65262 - OSP-OTHER-INCORROUT INCORRECT JOB INFORMATION RETURNED BY ST

PTF ( Program Temporary Fixes ) Cover letter


Order this fix

Abstract

OSP-OTHER-INCORROUT INCORRECT JOB INFORMATION RETURNED BY ST


Pre/Co-Requisite PTF / Fix List

REQ  LICENSED           PTF/FIX  LEVEL

TYPE PROGRAM  RELEASE   NUMBER   MIN/MAX  OPTION
---- -------- --------- -------  -------  ------
PRE  5770SS1  V7R2M0    SI59664   00/00    0000



NOTICE:
-------
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
foregoing.

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)
CL command.





APAR Error Description / Circumvention

-----------------------------------------------
When a connection is routed to a specific subsystem from the
default subsystem by using the SET_SERVER_SBS_ROUTING SQL
procedure, the fully qualified job name may be returned to the
client. When a connection is created the server does not return
the correct job name to the client. Programs that use this job
information on subsequent commands may fail.

This may happen with any host server when using the
SET_SERVER_SBS_ROUTING to route connections to another
subsystem.

CORRECTION FOR APAR SE67092 :
-----------------------------
The server incorrectly returns the name of the job performing
the initial processing of the connection and not the job
actually servicing the client. The PTF corrects the problem.

CIRCUMVENTION FOR APAR SE67092 :
--------------------------------
None


Activation Instructions


None.




Special Instructions


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 following names:
QNPSERVS, QZDASOINIT, QZDASSINIT, QZHQSSRV, QZRCSRVS, QZSCSRVS,
and QZSOSIGN.

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
command:

QSYS/STRPJ SBS(QSYSWRK) PGM(QIWS/QIWVPPJT)

Issue the STRHOSTSVR SERVER(*ALL) command to start the host servers.

********************************************************************
THE FOLLOWING ARE SUPERSEDED SPECIAL INSTRUCTIONS. IF THE SUPERSEDED
PTF HAS ALREADY BEEN APPLIED AND ITS SPECIAL INSTRUCTION FOLLOWED,
IT IS NOT NECESSARY TO FOLLOW THAT SPECIAL INSTRUCTION AGAIN.
********************************************************************

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI59914 :
=================================================

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
following names:
QNPSERVS, QZDASOINIT, QZDASSINIT, QZHQSSRV, QZRCSRVS, QZSCSRVS,
and QZSOSIGN.

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
command:

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
SET_SERVER_SBS_ROUTING
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)
command.
CRTSBSD SBSD(SBSLIB/MYSBS) POOLS((1 *BASE))
TEXT('Custom Server Subsystem')
2. Create a class for performance characteristics using the Create
Class
(CRTCLS) command.
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)
commands.
CRTJOBQ JOBQ(SBSLIB/MYSBS)
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)
PGM(QSYS/QCMD) CLS(SBSLIB/MYSBS)

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)
CLS(SBSLIB/MYSBS) STRJOBS(*YES)

Central server:
ADDPJE SBSD(SBSLIB/MYSBS) PGM(QSYS/QZSCSRVS) INLJOBS(1)
THRESHOLD(1) JOB(QZSCSRVS) JOBD(QSYS/QZBSJOBD) MAXUSE(200)
CLS(SBSLIB/MYSBS)

Network print server:
ADDPJE SBSD(SBSLIB/MYSBS) PGM(QSYS/QNPSERVS) INLJOBS(1)
THRESHOLD(1) JOB(QNPSERVS) JOBD(QSYS/QZBSJOBD) MAXUSE(200)
CLS(SBSLIB/MYSBS)

File server:
ADDPJE SBSD(SBSLIB/MYSBS) PGM(QSYS/QPWFSERVSO) INLJOBS(1)
THRESHOLD(1) JOB(QPWFSERVSO) JOBD(QSYS/QPWFSPJ)
MAXUSE(*NOMAX) CLS(SBSLIB/MYSBS)

6. Start the subsystem using the Start Subsystem (STRSBS) command.
STRSBS SBSD(SBSLIB/MYSBS)

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.

For example:
CALL QSYS2.SET_SERVER_SBS_ROUTING('MYUSER','QZHQSSRV','MYSBS','NO')
CALL QSYS2.SET_SERVER_SBS_ROUTING('MYUSER','QZSCSRVS','MYSBS','YES')
CALL QSYS2.SET_SERVER_SBS_ROUTING('MYUSER','QNPSERVS','MYSBS','NO')
CALL
QSYS2.SET_SERVER_SBS_ROUTING('MYUSER','QPWFSERVSO','MYSBS','NO')

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI58180 :
=================================================

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
following names:
QNPSERVS, QZDASOINIT, QZDASSINIT, QZHQSSRV, QZRCSRVS, QZSCSRVS,
and QZSOSIGN.

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
command:

QSYS/STRPJ SBS(QSYSWRK) PGM(QIWS/QIWVPPJT)

Issue the STRHOSTSVR SERVER(*ALL) command to start the host servers.


This PTF provides support for the remote command and distributed
program host server (QZRCSRVS) to service connections in subsystems for
a user or group profile when configured using the
SET_SERVER_SBS_ROUTING
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)
command.
CRTSBSD SBSD(SBSLIB/MYSBS) POOLS((1 *BASE))
TEXT('Custom Server Subsystem')
2. Create a class for performance characteristics using the Create
Class
(CRTCLS) command.
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)
commands.
CRTJOBQ JOBQ(SBSLIB/MYSBS)
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)
PGM(QSYS/QCMD) CLS(SBSLIB/MYSBS)

5. Add a prestart job entry to the subsystem.  For this server, add
a prestart job entry for QZRCSRVS.  For example:
ADDPJE SBSD(SBSLIB/MYSBS) PGM(QSYS/QZRCSRVS) INLJOBS(1)
THRESHOLD(1) JOB(QZRCSRVS) JOBD(QGPL/QDFTSVR)
MAXUSE(1) CLS(SBSLIB/MYSBS) STRJOBS(*YES)

6. Start the subsystem using the Start Subsystem (STRSBS) command.
STRSBS SBSD(SBSLIB/MYSBS)

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.

For example:
CALL QSYS2.SET_SERVER_SBS_ROUTING('MYUSER','QZRCSRVS','MYSBS')

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI56235 :
=================================================

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
following names:
QNPSERVS, QZDASOINIT, QZDASSINIT, QZHQSSRV, QZRCSRVS, QZSCSRVS,
and QZSOSIGN.

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
command:

QSYS/STRPJ SBS(QSYSWRK) PGM(QIWS/QIWVPPJT)

Issue the STRHOSTSVR SERVER(*ALL) command to start the host servers.


This PTF provides support for the database host server (QZDASOINIT) to
service connections in subsystems for a user or group profile when
configured using the SET_SERVER_SBS_ROUTING 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)
command.
CRTSBSD SBSD(SBSLIB/MYSBS) POOLS((1 *BASE))
TEXT('Custom Server Subsystem')
2. Create a class for performance characteristics using the Create
Class
(CRTCLS) command.
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)
commands.
CRTJOBQ JOBQ(SBSLIB/MYSBS)
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)
PGM(QSYS/QCMD) CLS(SBSLIB/MYSBS)

5. Add a prestart job entry to the subsystem.  For this server, add
a prestart job entry for QZDASOINIT.  For example:
ADDPJE SBSD(SBSLIB/MYSBS) PGM(QSYS/QZDASOINIT) INLJOBS(1)
THRESHOLD(1) JOB(QZDASOINIT) JOBD(QGPL/QDFTSVR)
CLS(SBSLIB/MYSBS) STRJOBS(*YES)

6. Start the subsystem using the Start Subsystem (STRSBS) command.
STRSBS SBSD(SBSLIB/MYSBS)

7. Configure user MYUSER to use this new subsystem for database
server connections using the SQL procedure.  Specify the user,
group, or supplemental group profile as appropriate.

For example:
CALL QSYS2.SET_SERVER_SBS_ROUTING('MYUSER','QZDASOINIT','MYSBS')


Default Instructions

THIS PTF CAN BE APPLIED IMMEDIATE OR DELAYED.



Supersedes

PTF/FIX NO(S).  APAR TITLE LINE
--------------  ------------------------------------------------------------
   SI59914      OSP-OTHER Configure host server subsystems by user
   SI58180      OSP-OTHER Configure remote command server subsystem by user
   SI56235      OSP-OTHER Configure database server subsystem by user

Summary Information

System.............................. i
Models..............................
Release............................. V7R2M0
Licensed Program............... 5770SS1
APAR Fixed.......................... View details for APAR SE67092
Superseded by:......................
Recompile........................... N
Library............................. QSYS
MRI Feature ........................ NONE
Cum Level........................... C8032720


System i Support

IBM disclaims all warranties, whether express or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. By furnishing this document, IBM grants no licenses to any related patents or copyrights. Copyright © 1996,1997,1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018 IBM Corporation. Any trademarks and product or brand names referenced in this document are the property of their respective owners. Consult the Terms of use link for trademark information.

Document information

More support for: i family

Software version: V7R2M0

Operating system(s): OS/400

Reference #: SI65262

Modified date: 29 June 2017