Send PTF Order (SNDPTFORD)

The Send Program Temporary Fix Order (SNDPTFORD) command allows you to prepare an order for:

Individual PTFs
Cumulative PTF package
PTF Group
Summary information for available PTFs
Preventive Service Planning (PSP) information

Restriction:

1. This command is shipped with public *EXCLUDE authority, and the QSRV and QSRVBAS user profiles have private authority to use the command.

2. The following restrictions apply for the IMGDIR parameter:

You must have *X authority to each directory in the path.
You must have *WX authority to the directory that contains optical image.

Keyword	Description	Choices	Notes
PTFID	PTF description	Values (up to 20 repetitions): Element list	Required, Positional 1
Element 1: PTF identifier	Character value, CUMPKG, HIPERGRP, DB2GRP, BRSGRP, JVAGRP, HTTPGRP, *PFRGRP
Element 2: Product	Character value, *ONLYPRD
Element 3: Release	Character value, *ONLYRLS
PTFPART	PTF parts	ALL, CVRLTR	Optional
RMTCPNAME	Remote control point	Communications name, IBMSRV, SELECT	Optional
RMTNETID	Remote network identifier	Communications name, *NETATR	Optional
DELIVERY	Delivery method	LINKONLY, ANY	Optional
DLVRYFMT	Delivery format	SAVF, IMAGE	Optional
ORDER	Order	REQUIRED, PTFID	Optional
REORDER	Reorder	NO, YES	Optional
CHKPTF	Check PTF	NO, YES	Optional
IMGDIR	Image directory	Path name, *DFT	Optional
IMGPFX	Image prefix	Character value, *DFT	Optional

PTF identifier (PTFID)

Specifies the list of PTFs being ordered.

Element 1: PTF identifier

*CUMPKG: Order the latest level of the cumulative PTF package (SF99vrm) for the operating system release that is installed on the system. HIPER and DB2 Universal Database (UDB) group PTFs are automatically requested with this order. It cannot be ordered with any other PTF identifier or special value.
*HIPERGRP: Order the latest level of HIPER PTF group for the operating system release that is installed on the system.
*DB2GRP: Order the latest level of DB2 UDB PTF group for the operating system release that is installed on the system.
*BRSGRP: Order the latest level of Backup Recovery Solutions PTF group for the operating system release that is installed on the system.
*HTTPGRP: Order the latest level of IBM HTTP Server PTF group for the operating system release that is installed on the system.
*JVAGRP: Order the latest level of Java PTF group for the operating system release that is installed on the system.
*PFRGRP: Order the latest level of Performance Tools PTF group for the operating system release that is installed on the system.
character-value: Specify the PTF identifier. Some PTFs must be ordered individually or within a list of PTFs with the same prefix and not as part of a general list.
A cumulative PTF package is specified using the format SF99vrm and the Preventive Service Planning (PSP) format is SF98vrm, where vrm is version-release-modification.

Element 2: Product

*ONLYPRD: The PTF identifier is associated with only one product.
Note: If this value and ORDER(*REQUIRED) are specified, requisites are sent for only that product that is installed or supported on your system.
character-value: Specify the 7-character product identifier of the product that the PTF is associated with. If the PTF identifier is associated with more than one product, the PTF order is limited to the product specified.

Element 3: Release

*ONLYRLS: The PTF identifier is associated with only one release.
Note: If this value and ORDER(*REQUIRED) are specified, requisites are sent for only that release level that is installed or supported on your system.
character-value: Specify the 6-character release level in VxRyMz format where Vx is the version number, Ry is the release number, and Mz is the modification level. The variables x and y can be a number from 0 through 9, and the variable z can be a number from 0 through 9 or a letter from A through Z.

PTF parts (PTFPART)

Specifies whether PTFs or cover letters are being ordered.

*ALL: PTFs and cover letters are being ordered.
*CVRLTR: Cover letters only are being ordered.

Remote control point (RMTCPNAME)

Specifies the remote control point of the service provider to whom the service request is sent.

*IBMSRV: The service request is sent to IBM service support.
*SELECT: A list of service providers is shown so the user can select the destination for the service request.
communications-name: Specify the name of the remote control point.

Remote network identifier (RMTNETID)

Specifies the remote name identifier of the service provider's network.

*NETATR: The service provider is in the local network.
communications-name: Specify the network name of the service provider to whom the request is being sent.

Delivery method (DELIVERY)

Specifies how the PTFs are delivered.

*LINKONLY: PTFs are delivered by the electronic customer support service link only. If the PTFs are too large to use service link, the command will fail.
*ANY: PTFs are delivered by any available method. The service link is used for most PTFs. PTFs that are too large for the service link are sent on the selected medium.

Delivery format (DLVRYFMT)

Specifies the format of the delivered PTFs.

*SAVF: PTFs are delivered through the electronic customer support service link as save files.
*IMAGE: PTFs are delivered through the electronic customer support service link as optical image files. Optical image files will contain PTFs and cover letter. The optical image file will be stored in the directory spacified by the IMGDIR parameter.

Order (ORDER)

Specifies the level of fixes that are being requested.

*REQUIRED: The PTF ordered and its requisites are being requested.
*PTFID: The specific PTF ordered is the one being requested. No requisites are sent.

Reorder (REORDER)

Specifies whether a PTF that is currently loaded, applied, or on order should be ordered again.

*NO: PTFs that are already loaded, applied, or on order are not reordered.
*YES: PTFs that are already loaded, applied, or on order are reordered.

Note: A PTF is not reordered if the *SAVF delivery format is specified and a save file is available on the system.

Check PTF (CHKPTF)

Specifies whether checking is performed on the service requester system to determine if PTFs are ordered based on whether or not the PTF product is installed or supported.

*NO: The PTFs specified on the PTF identifier (PTFID) parameter are ordered even when the PTF product is not installed or supported on the service requester.
*YES: The PTFs specified on the PTF identifier (PTFID) parameter are ordered only if the PTF product is installed or supported on the service requester.

Image directory (IMGDIR)

Specifies the directory where the optical image files are stored.

*DFT: The optical image files are stored in /QIBM/UserData/OS/Service/ECS directory.
path-name: Specify an existing directory. For more information on specifying path names, refer to "Object naming rules" in "CL concepts and reference" in the CL reference information in the iSeries Information Center at http://www.iseries.ibm.com/infocenter.

Image prefix (IMGPFX)

Specifies a prefix for the optical image file names.

*DFT: The files will be named by the Service Provider.
character-value: Specify the prefix that will be used when naming the optical images being stored. If multiple images are received under one order, the files will be uniquely identified by a numerical suffix on the image name. For more information on specifying file names, refer to "Object naming rules" in the CL concepts and reference topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.

Examples

Example 1: Sending Order for PTFs by PTF Number only

SNDPTFORD   PTFID((SI12345) (SI12346))

This command sends a request for PTF numbers SI12345 and SI12346.

Example 2: Sending Order for PTF by Product and Release

SNDPTFORD   PTFID((SI12345 5722SS1 V5R3M0))
            DELIVERY(*ANY)  ORDER(*REQUIRED)

This command sends a request for PTF SI12345 for Version 5 Release 1 Modification 0 of the operating system product (5722SS1). The PTF can be delivered by any available method. Any requisites are sent with the PTFs.

Example 3: Sending Order for Latest Cumulative PTF

SNDPTFORD   PTFID((*CUMPKG))

This command requests that the latest PTF cumulative package be sent for the operating system release level that is installed on your system.

Example 4: Sending Order for a PTF Group

SNDPTFORD   PTFID((SF99893))

This command sends a request for PTF group number SF99893.

Example 5: Sending Order for a DB2 UDB Group with *IMAGE Delivery format

SNDPTFORD   PTFID((*DB2GRP))  DELIVERY(*LINKONLY)
            DLVRYFMT(*IMAGE)

This command sends a request for the latest level of the DB2 UDB PTF group for the operating system release that is installed on your system. The PTF group will be stored in optical image files inside /QIBM/UserData/OS/Service/ECS directory.

Error messages

*ESCAPE Messages

CPF2702: Device description &1 not found.
CPF7C08: No support network connection.
CPF8C0C: Content of problem record &1 not valid.
CPF8C0E: Library QGPL not found.
CPF8C01: Cannot connect to IBM service system. One session allowed.
CPF8C07: A parameter is not valid.
CPF8C08: Cannot specify *SELECT for the control point name.
CPF8C09: &1 not defined as a service provider.
CPF8C16: Error occurred while processing request.
CPF8C17: Sign-on failed.
CPF8C18: No support network connection.
CPF8C19: Remote support application failed.
CPF8C2A: Cannot connect to IBM service system.
CPF8C24: Error occurred while processing request.
CPF8C27: Alternate load device not found.
CPF8C32: PTF order cannot be processed.
CPF8C99: PTF &2-&1 &3 not ordered.
CPF9846: Error while processing file &1 in library &2.