Processing Profiles

All SYSMAIN functions except the find function can be performed on the following types of profile: device profiles, editor profiles, map profiles and parameter profiles. Device, editor and map profiles are created with the program editor or the map editor. Parameter profiles are created with the SYSPARM utility.

This section describes menu functions and selection list options provided to perform a SYSMAIN function on profiles and the syntax that applies when using direct commands.

Related Topic:


Fields in the Profiles Menu

The Profiles menu contains all SYSMAIN functions required for the processing of profiles. The fields provided in the menu are described in the following table:

Field Explanation
Code
Specifies the function to be performed as described in Description of Functions:
   
C Copy profile.
D Delete profile.
L List profile.
M Move profile.
R Rename profile.
Sel. List
Specifies whether selective processing or automated processing is used:
   
Y Yes.
Selective processing is activated. A selection list is displayed when processing profiles. This is the default setting. For the columns and line commands available on a selection list, see Selection Lists for Profiles.
N No.
Selective processing is deactivated.
Name The name of the profile to be processed or a range of names: see also Specifying a Range of Names.
New Name The name to be given to a profile when it is renamed with the rename function.
Type
The type of profile to be processed:
   
D Only device profiles are processed.
E Only editor profiles are processed.
M Only map profiles are processed.
P Only parameter profiles are processed.
*
or
empty field
All profiles are processed. This is the default setting.
   
Types D, E, M and P can be used in any combination.
Database The database ID (DBID) of a source or a target database.

The source database contains the system file where the profile to be processed is stored. The target database contains the system file to which the profile is to be copied or moved, or where the profile is renamed.

Valid database IDs are 1 to 65535.

File The file number (FNR) of a source or a target system file.

Valid file numbers are 1 to 65535.

The source file contains the profile to be processed. The target file is the file to which the profile is to be copied or moved, or where the profile is renamed.

Name
(below New Name)

Only applies to VSAM files.

The DDNAME/FCT entry for the source or target file number.

Replace
Specifies whether a profile is to be replaced when using the move, copy or rename function:
   
Y Yes.
A profile with the same name which exists in the target environment is replaced.
N No.
A profile with the same name which exists in the target environment is not replaced. This is the default setting.
   
See also Using the Replace Option.

Selection Lists for Profiles

If selective processing has been activated, a selection list of all profiles that meet the specified selection criteria is displayed on a Selection screen.

This section describes the columns contained on a Selection screen and the line commands provided to further process a profile:

Columns

The following columns are displayed on a Selection screen:

Column Explanation
C Input field for line commands (see below).
Profile The name of the profile that meets the specified selection criteria.
Type
The type of profile:
   
D Device profile.
E Editor profile.
M Map profile.
P Parameter profile.
Message The message which indicates the current processing status of a profile. For possible messages, see Status Messages.

Line Commands

The line commands that can be entered in the C (Command) column of a Selection screen are listed in the following table. Line commands E, M, D and P can be entered in any combination.

Line
Command

Function
A Process device profiles, editor profiles, map profiles and/or parameter profiles.
D Process only device profiles, even if there are editor, map and parameter profiles listed as well. If D is specified for a profile which does not exist as a device profile, an error occurs.
E Process only editor profiles, even if there are device, map and parameter profiles listed as well. If E is specified for a profile which does not exist as an editor profile, an error is returned.
M Process only map profiles, even if there are device, editor and parameter profiles listed as well. If M is specified for a profile which does not exist as a map profile, an error is returned.
L Display the contents of a parameter profile.
P Process only parameter profiles, even if there are device, editor and map profiles listed as well. If P is specified for a profile which does not exist as a parameter profile, an error is returned.

Direct Command Syntax for Profiles

This section shows the syntax that applies when performing a SYSMAIN function on profiles by using direct commands in either online or batch mode. For general instructions on using direct commands, refer to Executing Commands.

For explanations of the keywords and variable values used in the syntax diagrams below, refer to Keywords and Variables in Direct Commands. The symbols in the syntax diagrams correspond to the syntax symbols used for system commands. These symbols are explained in System Command Syntax in the System Commands documentation.

The syntax of the where-clause and the with-clause are identical for each command.

This section covers the following topics:

COPY and MOVE

COPY
MOVE

PROFILE name [with-clause] FM [where-clause] TO [where-clause]

Examples:

COPY PRO USER1 TYPE E FM DBID 1 FNR 5 TO DBID 2 FNR 5
C PROFILE USER TYPE MED REP FM FNR 6 TO FNR 7
COPY PRO USER1 TYPE P FM DBID 10 FNR 44 TO DBID 3 FNR 7
MOVE PRO USER1 TYPE E FM DBID 1 FNR 5 TO DBID 2 FNR 5
M PROFILE USER1 TYPE MED REP FM FNR 6 TO FNR 7

DELETE

DELETE PROFILE name

IN [where-clause]

[with-clause]

Examples:

DELETE PRO U* TYPE DM
D PRO TEST* IN DBID 177 FNR 205

LIST

LIST PROFILE name

IN [where-clause]

[with-clause]

Examples:

LIST PRO USER* IN DBID 1 FNR 5
L PRO DT* TYPE E

RENAME

RENAME PROFILE name AS new-name
      IN where-clause]
      TO [where-clause] [with-clause]

Examples:

RENAME PROFILE USER1 AS USER2 RCOP
R PRO USER1 AS USER2 DBID 1 FNR 4 TO DBID 1 FNR 5
R PRO USER1 AS NEWUSER IN FNR 4 TO FNR 5 REPLACE RCOP

where-clause

[WHERE] [DBID dbid] [FNR fnr] [NAME vsam-name]
[CIPHER cipher]

PASSWORD
PSW

password

   

with-clause

[WITH] [TYPE type] [REPLACE] [RCOP]

PROMPT
NOPROMPT

MON
NOMON

[HELP]