The Work With RSF Catalog (WRKRSFCAT) command is used to work with a list of RSF packages available from a given server, or to print a list of packages available from a given server.
While working with an RSF catalog, you can easily display and delete catalog entries, retrieve packages, and retrieve catalog updates.
The prompted version of the WRKRSFCAT command is shown below.
Work With RSF Catalog (WRKRSFCAT) Type choices, press Enter.
Server ID . . . Name Output . . . * *, *PRINT Detail . . . *BASIC *BASIC, *FULL
Bottom
F3=Exit F4=Prompt F5=Refresh F12=Cancel F13=How to use this display F24=More keys
The parameters for the WRKRSFCAT command are described below.
Server ID
The name of the server whose catalog is to be worked with. This is a required parameter. The possible values are:
Name: Enter the name of an existing server directory entry. Output
Indicates whether the list should be displayed or printed. The possible values are:
*: Display the list. *PRINT: Print the list. Detail
Controls the amount of detail shown when printing the list. The possible values are:
*BASIC: A subset of the total information is shown for each catalog entry. Multiple entries are printed
per page.
The display that is presented when you specify OUTPUT(*) on the WRKRSFCAT command is shown below. Work With RSF Catalog BUG0710
Server . . . : BUGBUSTERS Bug Busters Software Engineering
Position to . . .
Type options, press Enter.
4=Delete 5=Display 8=Retrieve package 10=Install Opt Package Sts Text
A_WHATSNEW What's New? Retrieve this cover letter for info. ALC2.0 A la Carte Menu and Security System - Free Trial ALC2.0_001 ALC 2.0 PTF 07/14/09: DSPALCAUT enhancement ALC2.0_002 Superseded by 003: LMTCPB menu option error ALC2.0_003 ALC 2.0 PTF 10/01/09: Prompting cmd after error ALC2.0_004 ALC 2.0 PTF 3/11/09: Authority w/ adoption CDB CD Builder - Free Trial
COMTOOLS Communications configuration tools
RSF_NEWRLS Remote Software Facility - Release 8.6 10/1/10
More... F3=Exit F4=Prompt F5=Refresh F12=Cancel F13=Change defaults F15=Update catalog F21=System command
The following function keys may be used with this display:
F3: Exit without updating. F4: Prompt.
F5: Refresh the display. F12: Cancel.
F13: Change defaults that effect this display. F15: Retrieve the latest catalog.
F21: Present a system command line window.
The fields on the Work With RSF Catalog display are explained below.
Server
The name and text for the server whose catalog is being worked with are shown.
Position to
Enter a value in the "Position to" field and press Enter to position the list to a specific entry. The cursor is positioned to the first entry in the list that is greater than or equal to the "Position to" value you specify.
Opt
Enter an option number in the "Opt" column beside a list entry, and press Enter to perform a function on the list entry. You may enter options beside several list entries before pressing Enter. The options for the list entries are processed in turn when you press Enter. The following is a list of options and their functions.
4=Delete: A display is presented allowing you to confirm your choices for delete. When you press Enter
a second time, the entries are deleted.
5=Display: Detailed information about the entry is displayed.
8=Retrieve package: Retrieve the package from the server. Press Enter to retrieve the package. Press F4
to be prompted for parameters before retrieving the package. The package is retrieved interactively or in batch, depending on the values specified for defaults. Press F13 to view or change the defaults.
10=Install: The selected package is installed on your system. The package status must be RTV or OPN. Package
The names of the packages available from the server are shown in this column.
Status
The package status is shown. The possible values are:
blank: The package has not been retrieved or installed. RTV: The package has been retrieved but not installed. INL: The package has been installed.
OPN: The package has been retrieved again after it was installed. Text
Text describing each package is shown in this column.
F15=Update catalog
Press F15 to retrieve the latest catalog from the server. The catalog is retrieved interactively or in batch, depending on the values specified for defaults. Press F13 to view or change the defaults.
F13=Change defaults
The display that is presented when you press F13 to change defaults from the WRKRSFCAT display is shown below. You can also access this display by running the Change User Options (CHGRSFUO) command from any command line. Click on the image to see parameter descriptions.
Change RSF User Options (CHGRSFUO) Type choices, press Enter.
Target save file . . . *PKG Name, *PKG Library . . . QGPL Name, *CURLIB Replace existing save file . . . *NO *YES, *NO Automatic installation . . . *YES *YES, *NO Retrieve package if installed . *NO *YES, *NO Run in batch . . . *NO *YES, *NO Job description . . . MY_JOBD Name, *USRPRF
Library . . . MY_LIB Name, *LIBL, *CURLIB Earliest date to include . . . . *FIRST Date, *FIRST, *NEW
Last date to include . . . *LAST Date, *LAST
Entry status to include . . . . *ALL *ALL, *NOTBLANK, *NOTINL... + for more values
Text compare string . . . . . . *ALL
Option file . . . RSFOPT Name
Library . . . *LIBL Name, *LIBL, *CURLIB Option member . . . *FIRST Name, *FIRST
Default server . . . *NONE Name, *NONE Default package . . . *NONE Name, *NONE
Target release . . . *CURRENT VxRyMz, *CURRENT, *PRV... Outgoing mail from address . . . *DFT
Bottom
F3=Exit F4=Prompt F5=Refresh F12=Cancel F13=How to use this display F24=More keys
The following function keys may be used with this display:
F3: Exit without updating. F12: Cancel.
The fields on the Change Defaults display are explained below.
Target save file
The qualified name of a save file on your machine where retrieved packages should be placed. If the save file specified does not exist when the package is retrieved, it will be created.
The possible values are:
*PKG: Use the name of the package being retrieved for the save file name. name: Enter the name of the save file to contain retrieved packages.
The possible library values are:
QGPL: Library QGPL is used.
*CURLIB: Your current library is used.
library name: Enter the name of a library to contain the save file. Replace save file
Specify the action to take when the specified save file already exists. The possible values are:
*YES: Replace an existing save file.
Automatic installation
Specify whether to automatically install retrieved packages. The possible values are:
*YES: RSF runs program RSFINST if it is included within a retrieved package. *NO: Package save files are not automatically installed.
Retrieve package if installed
Specify whether to retrieve packages that are already flagged as installed on your system. The possible values are:
*NO: A request to retrieve an installed package ends in error. *YES: Installed packages may be retrieved again.
Run in batch
Specify whether to submit requests to batch. The possible values are:
*NO: Run requests interactively. *YES: Submit requests to batch. Job description
Enter the qualified name of a job description to use when submitting requests to batch. The possible values are:
name: Enter the name of the job description to use.
The possible library values are:
*LIBL: The job description is found using the library list. *CURLIB: The job description in the current library is used.
library-name: Enter the name of the library containing the job description. Earliest date to include
Enter the earliest date to include in the catalog list. Only catalog entries that were created or changed on or after the date specified are included.
*FIRST: No minimum date is used to filter catalog entries.
*NEW: Only new entries that were added to the catalog since the last time the catalog was retrieved are
included.
date: Enter the earliest date to include in the list. Last date to include
Enter the latest date to include in the catalog list. Only catalog entries that were created or changed on or before the date specified are included.
The possible values are:
*LAST: No maximum date is used to filter catalog entries. date: Enter the latest date to include in the list.
Entry status to include
Use this parameter to select entries to include by status. The possible single values are:
*ALL: All entries are included regardless of status.
*NOTBLANK: Entries with any status other than blank are included. *NOTINL: Entries for packages that have not been installed are included.
The other possible values are:
*BLANK: Entries for packages that have not been retrieved or installed are included. *RTV: Entries for packages that have been retrieved but not installed are included. *INL: Entries for packages that have been installed are included.
*OPN: Entries for packages that have been retrieved again after they were last installed are included. Text compare string
Enter characters to compare to catalog entry text to determine which entries should be included in the list. An entry is included in the list if the entry text contains the string specified.
The possible values are:
*ALL: Include all entries regardless of their text. string: Enter a text compare string to use.
Option file
The possible values are:
file-name: Enter the name of an existing option file.
The possible library values are:
*CURLIB: The file is found in the job's current library.: *LIBL: The file is found using the library list.:
library-name: Enter the name of the library containing the option file.: Option member
Enter the name of the option file member to use. The possible values are:
*FIRST: The first member in the file is used. member-name: Enter a valid member name. Default server
Specify a default server ID to use to replace the &SERVER variable in user-defined options. This value is only used with the Work With Packages display.
The possible values are:
*NONE: No default is specified. server-ID: Enter a valid server ID. Default package
Specify a default package to use to replace the &PKG variable in user-defined options. This value is only used with the Work With Servers and Work With Catalog displays.
The possible values are:
*NONE: No default is specified.
package-name: Enter a valid package name. Target release
Enter the default to use for the OS/400 release level of the remote machine, relative to your machine. The possible values are:
*CURRENT: The remote server machine is at the same OS/400 release level as the local machine. *PRV: The remote server machine is one OS/400 release level behind your machine.
*TARGET: RSFLINK is used to query the actual release of the target machine. If the OS/400 release of
the target machine is greater than the release of the local machine, a value of *CURRENT is used. Otherwise, the actual release of the target machine is used.
release-level: Enter the OS/400 release level of the remote machine, in the form VxRyMz, where x, y
and z are the version, release and mod level respectively. For example: V7R1M0.
Outgoing mail from address
Specify your email address. This is the address to which replies to your outgoing email will be directed. The possible values are:
*DFT: The value specified in the global RSF defaults is used. See the Change RSF Defaults
(CHGRSFDFT) command for more information.
email-address: Enter the email address to which replies to your outgoing emails
should be directed. For example: fred.jones@your_company.com
Related Commands:
The following commands are discussed elsewhere in this manual:
Retrieve Package (RTVRSFPKG)
Send Package (SNDRSFPKG)
Create Package (CRTRSFPKG)
For more information about the following commands, prompt the command and press F1 to view the on-line help text:
Change Package (CHGRSFPKG) Delete Package (DLTRSFPKG) Rename Package (RNMRSFPKG)