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 Groups
- 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, *ALLGRP, *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 PTF information being ordered.
Element 1: PTF identifier
- *CUMPKG
- Order the latest level of the Cumulative PTF package group (SF99vrm) for the operating system release that is installed on the system. The HIPER and DB2 for IBM i PTF groups are automatically included when the Cumulative PTF package PTF group is specified. This value cannot be specified with any other PTF identifier or special value.
- *ALLGRP
- Order the latest level of all PTF groups for the installed operating system release, except the Cumulative PTF package group.
- *HIPERGRP
- Order the latest level of the HIPER PTF group for the operating system release that is installed on the system.
- *DB2GRP
- Order the latest level of the DB2 for IBM i PTF group for the operating system release that is installed on the system.
- *BRSGRP
- Order the latest level of the Backup Recovery Solutions PTF group for the operating system release that is installed on the system.
- *HTTPGRP
- Order the latest level of the IBM HTTP Server for i PTF group for the operating system release that is installed on the system.
- *JVAGRP
- Order the latest level of the Java PTF group for the operating system release that is installed on the system.
- *PFRGRP
- Order the latest level of the Performance Tools PTF group for the operating system release that is installed on the system.
- character-value
- Specify the identifier of the PTF information being ordered. 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, the Preventive Service Planning (PSP) package format is SF98vrm, and the PTF Summary package format is SF97vrm, where vrm is version-release-modification. A PTF group is specified using the format SF99xxx.
The HIPER and DB2 for IBM i PTF groups are automatically included when the cumulative PTF package PTF group SF99vrm is specified for the operating system release that is installed on the system.
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 the 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 if requisite PTFs should be included with the ordered PTFs.
- *REQUIRED
- The specified PTFs and their requisite PTFs are being requested.
- *PTFID
- The specified PTFs are being requested. No requisite PTFs 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 order 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
- 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 IBM i Knowledge Center at http://www-01.ibm.com/support/knowledgecenter/ssw_ibm_i/welcome.
| 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 IBM i Knowledge Center at http://www-01.ibm.com/support/knowledgecenter/ssw_ibm_i/welcome.
| 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 that are downloaded.
| 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 57xxSS1 VxRyMz))
DELIVERY(*ANY) ORDER(*REQUIRED)
This command sends a request for PTF SI12345 for Version x Release y Modification z of the operating system product (57xxSS1). The PTF can be delivered by any available method. Any requisites are sent with the PTFs.
Example 3: Sending Order for Cumulative PTF Package
SNDPTFORD PTFID((*CUMPKG))
This command sends a request for the latest cumulative PTF package for the operating system release level that is installed on your system. The HIPER and DB2 for IBM i PTF groups are automatically included in the order.
Example 4: Sending Order for a PTF Group
SNDPTFORD PTFID((SF99893))
This command sends a request for PTF group SF99893.
Example 5: Sending Order for DB2 for IBM i PTF Group with *IMAGE Delivery Format
SNDPTFORD PTFID((*DB2GRP)) DELIVERY(*LINKONLY)
DLVRYFMT(*IMAGE)
This command sends a request for the latest level of the DB2 for IBM i PTF group for the operating system release that is installed on your system. The PTF group will be stored in optical image files in the /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 for IBM i PTF group for the operating system release that is installed on your system. The PTF group will be ordered but it will not be downloaded. The status of this PTF order will be ONORDER and the Work with PTF Order (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 image catalog MYCATALOG will be created if it does not already exist. The PTF group image will be stored in the image catalog MYCATALOG.
| 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 |