Send PTF Order (SNDPTFORD)
Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
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
Restrictions:
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.
3. The following restrictions apply for the IMGCLG parameter:
- You must have the authorities needed to run the Create Image Catalog (CRTIMGCLG) command.
- You must have read(*READ) and add(*ADD) authorities to the QUSRSYS library.
Top |
Parameters
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 |
IMGOPT | Image option | *DOWNLOAD, *ORDER | Optional |
IMGDIR | Image directory | Path name, *DFT | Optional |
IMGPFX | Image prefix | Character value, *SRVPVD | Optional |
IMGCLG | Image catalog | Name, *NONE | Optional |
Top |
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 one of the following formats:
- VxRyMz, 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.
- vvrrmm, where version vv and release rr must be a number from 00 through 35, and modification mm must be a number from 00 through 09 or a letter from 0A through 0Z. The leading zeros are required. This format must be used if the version or release of the product is greater than 9.
Top |
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.
Top |
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.
Top |
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.
Top |
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.
Top |
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 letters. The optical image file will be stored in the directory specified by the IMGDIR parameter.
Top |
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.
Top |
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.
Top |
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.
Top |
Image option (IMGOPT)
Specifies the option of the image order.
- *DOWNLOAD
- The optical image can be ordered and downloaded automatically when the optical image is ready to download.
- *ORDER
- The optical image will be ordered but it will not be automatically downloaded. The Work with PTF Order (WRKPTFORD) command can be used to display PTF orders information, download or cancel the order.
Note: The user has up to 14 days to resume or cancel a PTF order because the Fix Service Provider will close all orders after 14 days.
Top |
Image directory (IMGDIR)
Specifies the directory where the optical image files are stored. If IMGCLG parameter is specified, the directory specified will be associated with the image catalog.
- *DFT
- The optical image files are stored in /QIBM/UserData/OS/Service/ECS directory.
- path-name
- :* A1C From: Specify an existing directory. For more information on specifying path names, refer to "Object naming rules" in the "CL concepts and reference" topic in the i5/OS Information Center at http://www.ibm.com/systems/i/infocenter/.
Top |
Image prefix (IMGPFX)
Specifies a prefix for the optical image file names.
- *SRVPVD
- 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 i5/OS Information Center at http://www.ibm.com/systems/i/infocenter/.
Top |
Image catalog (IMGCLG)
Specifies the image catalog to create based on the PTFs ordered.
- *NONE
- No image catalog will be created.
- name
- Specify the name that will be used when creating the image catalog. If the image catalog already exists, it will be used to store the images download.
Top |
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 3 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.
Example 6: Sending Order with *IMAGE Delivery Format
SNDPTFORD PTFID((*DB2GRP)) DELIVERY(*LINKONLY) DLVRYFMT(*IMAGE) IMGOPT(*ORDER)
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 order will be ordered but it will not be donwloaded. The status of this PTF order will be "onorder" and WRKPTFORD command can be used to display PTF order information, download or cancel the order.
Example 7: Sending Order with Image Catalog Option
SNDPTFORD PTFID((*HIPERGRP)) DELIVERY(*LINKONLY) DLVRYFMT(*IMAGE) IMGCLG('MYCATALOG')
This command sends a request for the latest level of the Hiper PTF group for the operating system release that is installed on your system. The PTF image will be stored in the MYCATALOG image catalog.
Top |
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 &6 not ordered.
- CPF9846
- Error while processing file &1 in library &2.
Top |