RMVRMTPTF (Remove Remote Program Temporary Fix)

Note: To use this command, have the 5722-SM1 (System Manager for iSeries) licensed program installed.

RMVRMTPTF Command syntax diagram

 

Purpose

The Remove Remote Program Temporary Fix (RMVRMTPTF) command allows a service provider to remotely remove PTFs from a service requester's system. When using the RMVRMTPTF command, you can request an IPL of the service requester's system. The remove PTF and IPL can be scheduled to occur at a later date and time.

Note: A change request is automatically submitted that can be viewed to determine the status of this command. Use the Work with Submitted Change Request (WRKSBMCRQ) command to monitor the status.

 

Restrictions

  1. The remove and IPL functions of this command are only supported when the service requester has the Managed System Services licensed program installed.

  2. If a NODL value is specified, the node list can only contain entries that have value of *SNA for the address type.

  3. PTFs are always removed temporarily except Vertical Licensed Internal Code (VLIC) PTFs which are removed permanently.

  4. Dependent PTFs must already be removed on the service requester. PTFs are removed in the order that they are listed on the command.

 

Required Parameters

PTFID
Specifies the PTF that is to be removed. A maximum of 300 PTF identifiers can be specified.

Element 1: PTF Identifier

ptf-identifier: A 7-character PTF identifier.

*ALL: Removes all PTFs for the specified product.

Element 2: Product Identifier

*ONLY: Specifies that the PTF identifier is associated with only one product.

product-id: Specify the product of the PTF. The product must be specified when PTF identifiers are not unique across products or the PTF identifier is *ALL.

Element 3: Release Level of Product

release(VxRxMx): Specify the release level of the product. The format is VxRxMx.

DESTSRVRQS
Specifies the service requester where this PTF function is to be performed. A single service requester or a list of service requesters can be specified.

Element 1: Network Identifier

*SELECT: Shows a list of service requesters. From the list, you can select one or more service requesters. *SELECT is not valid when the command is used in a batch environment.

*ALL: Specifies that this PTF function should occur on all of the service requesters that are defined for this service provider.

*NONE: The service requesters are identified in a node list object.

*NETATR: The remote network identifier of the service requester is the same as the network identifier of this system.

remote-network-identifier: Specify the remote network identifier of the service requester.

Element 2: Control Point

This element is not valid when the network identifier is *ALL, *SELECT, or *NODE.

remote-control-point: Specify the remote control point name of the service requester.

 

Optional Parameters

DLYRMV
Specifies how PTFs are removed. Remove immediate PTFs at the time the activity runs on the specified system or later during the next IPL.

*NO: Removes an immediate PTF at the time the activity runs. If the PTF is marked delayed, it is not applied until the next unattended IPL.

*YES: Removes both immediate or delayed PTFs during the next unattended IPL.

NODL
Specifies the node list object name that contains a list of service requesters where this PTF function is to be performed.

*NONE: The service requesters are identified in the DESTSRVRQS parameter.

The possible library values are the following:

*LIBL: Searches all of the libraries in the user and system portions of the job's library list for the node list object.

*CURLIB: Searches for the node list object in the library for the current job.

library-name: Specify the name of the library to be searched.

node-list-name: Specify the node list name that contains the list of service requesters where this PTF function is to be performed.

RMTRMVTIME
Specifies the date and time when this PTF function can occur on the service requester. The current date and time values and next date are determined, when this PTF function is processed on this system, based on this system's date and time.

Element 1: Time Zone

*LCLSYS Specifies the remote start time in the time zone of this system.

*MGDSYS: Specifies the remote start time in the time zone of the service requester's system.

Element 2: Start After Time

*CURRENT: Starts this PTF function on the service requester system at any time on or after this PTF function request is processed on this system.

start-after-time: Specify the time when this PTF function can be started on the service requester. The time can be entered as 4 or 6 digits, such as hhmm or hhmmss where hh = hours, mm = minutes, and ss = seconds. Seconds are optional. The time can be specified with or without a separator. With a time separator, specify a string of 5 or 8 digits (hh:mm or hh:mm:ss).

Element 3: Start After Date

*CURRENT: Starts this PTF function on the service requester system on any date on or after the date this PTF function is processed on this system.

*NEXT: Starts this PTF function on the service requester system on any date after the date this PTF function is processed on this system.

start-after-date: Specify the date when this PTF function can start on the service requester system. The date must be specified in the job date format.

Note: The special values *CURRENT and *NEXT cannot be specified for the date and time when the time zone value *MGDSYS is specified.

IPL
Specifies if an IPL of the service requester's system should occur.

*NO: An IPL of the service requester system should not occur.

*YES: An IPL of the service requester system should occur after all the PTFs listed on the command are successfully removed.

RMTIPLTIME
Specifies the date and time when the IPL can occur on the service requester. The current date and time values and next date are determined, when this IPL request is processed on this system, based on this system's date and time.

Element 1: Time Zone

*LCLSYS Specifies the remote start time in the time zone of this system.

*MGDSYS: Specifies the remote start time in the time zone of the service requester's system.

Element 2: Start After Time

*CURRENT: Starts the IPL on the service requester system at any time on or after the IPL request is processed on this system.

start-after-time: Specify the time when the IPL can be started on the service requester. The time can be entered as 4 or 6 digits, such as hhmm or hhmmss where hh = hours, mm = minutes, and ss = seconds. Seconds are optional. The time can be specified with or without a separator. With a time separator, specify a string of 5 or 8 digits (hh:mm or hh:mm:ss).

Element 3: Start After Date

*CURRENT: Starts the IPL on the service requester system on any date on or after the date this IPL request is processed on this system.

*NEXT: Starts the IPL on the service requester system on any date after the date this IPL request is processed on this system.

start-after-date: Specify the date when the IPL can start on the service requester system. The date must be specified in the job date format.

Note: The special values *CURRENT and *NEXT cannot be specified for the date and time if the time zone value *MGDSYS is specified.

PWRDWNOPT
Specifies how to manage the end of active jobs during IPL process at the service requester system. This parameter is valid only if IPL(*YES) is specified.

*CNTRLD: All jobs end when the specified time in the Power down delay (PWRDWNDLY) parameter expires. Any current jobs that are running will perform an end of batch processing.

*IMMED: Jobs end immediately.

PWRDWNDLY
This parameter is valid only if IPL(*YES) and if PWRDWNOPT(*CNTRLD) are specified. Specifies the amount of time in seconds that the system allows a controlled end to be performed. If the end of job routines are not finished in the specified power down delay, any remaining jobs are ended immediately.

3600: The amount of time in which to complete a controlled end of processing is limited to 3600 seconds.

delay-time: Specify the maximum amount of delay time, in seconds, in which a controlled end can be performed. Valid values range from 1 through 65535 (65,535 seconds).

Examples for RMVRMTPTF

Example 1: Removing a PTF 

RMVRMTPTF PTFID((123456 *ONLY V5R2M0))  DESTSRVRQS(*SELECT)

Remove a PTF from one or more selected service requesters.

Example 2: Removing a PTF on a Certain Date 

RMVRMTPTF PTFID((*ALL PRODUCT V5R2M0))
  DESTSRVRQS((*NETATR CHICAGO1)   (*NETATR CHICAGO2))
  RMTAPYTIME((*MGDSYS ('10:00:00' '10/31/02'))   IPL(*YES)
  RMTIPLTIME((*MGDSYS ('01:00:00' '11/01/02'))

This example removes the PTFs on the service requesters starting at 10:00 a.m. on October 31, 2002. If all the PTFs were removed successfully, the service requester's system IPL starts at 1:00 a.m. on November 1, 2002.

Example 3: Doing an IPL after removing a PTF 

RMVRMTPTF PTFID((987654 *ONLY V5R2M0))
  DESTSRVRQS(*SELECT)'))   IPL(*YES)
  RMTIPLTIME(*LCLSYS (*CURRENT 12/24/2002))
  PWRDWNOPT(*IMMED)

To remove a PTF from one or more selected service requesters, the IPL should occur for all selected service requesters. This example removes the PTF on the service requesters. If the PTF is removed sucessfully, the IPL on the remote system starts at the current time on December 24, 2002. The times specified are in the time zone of the local system.

Example 4: Removing a PTF with two corequisite PTFs and one prerequisite PTF 

RMVRMTPTF PTFID((SF00001 *ONLY V5R2M0))
  DESTSRVRQS(*SELECT) RMTRMVTIME(*LCLSYS (*CURRENT *CURRENT))
  IPL(*NO)

Remove PTF number SF00001. This PTF has 2 corequisite PTFs and one prerequisite PTF. PTFs SF00002 and SF00003 are corequisite PTFs for PTF SF00001. PTF SF00004 is a prerequisite for PTF SF00001. The system will remove PTFs SF0001, SF00002, and SF00003. However, the prerequisite PTF will not be removed. The system will determine all corequisite PTFs if they were not specified. No IPL will be performed, and this action applies the PTFs on the service requesters. The times specified are in the time zone of the local system.

Error messages for RMVRMTPTF

*ESCAPE Messages

CPF358A
PTF &1-&2 cannot be applied or removed.