PROFILE subcommand — set preferred line and page size defaults

Use the PROFILE subcommand to establish defaults for reports generated under IPCS:

A preferred line size
Preferred lines per printed page

The defaults you specify with PROFILE are recorded in your dump directory and remain in effect until you change them. You can issue PROFILE at any time during an IPCS session to view your default values. To change one or more of your defaults, enter the PROFILE subcommand with the parameters for the defaults.

Except for NOPAGESIZE, a newly established default is used for both the current session and any subsequent sessions in which you use the same dump directory. NOPAGESIZE does not become effective until the beginning of your next IPCS session.

Unlike the defaults set by a SETDEF subcommand, the PROFILE defaults cannot be overridden by parameters on other IPCS subcommands. The defaults can be changed only by entering a PROFILE subcommand.

The PROFILE-defined defaults shipped with IPCS are:

Figure 1. PROFILE-Defined Defaults

/*---------------------- IPCS Profile Data ------------------------*/
PROFILE NOEXCLUDE             /* No dump analysis excluded         */
PROFILE NOLINESIZE            /* Limit for variable-width reports  */
PROFILE NOPAGESIZE            /* Line limit for print file pages   */
PROFILE STACK(NODUPLICATES)   /* Duplicate stack entry screening   */

Note:

The NOLINESIZE parameter is the equivalent to a line size of 250 characters per line. Variable-width reports can appear somewhat different when the output is directed to the terminal or the IPCS print data set.
The NOPAGESIZE parameter causes IPCS to use the PAGESIZE supplied in the IPCS session parameters member. If PAGESIZE is not supplied in the session parameters member, IPCS uses a default of 60 lines per page.

See z/OS MVS IPCS User's Guide for information about using the PROFILE subcommand to set print data set report defaults,

Related subcommands
- ANALYZE
- EVALPROF
- OPEN
- WHERE

Syntax

  { PROFILE } [ EXCLUDE(name[ :name]...) | NOEXCLUDE ]
  { PROF    } [ LINESIZE(nnn) | NOLINESIZE ]
              [ PAGESIZE(nnn) | NOPAGESIZE ]
              [ LIST | NOLIST ]
              [ STACK {(DUPLICATES | NODUPLICATES)} ]

-------- SETDEF-Defined Parameter --------------------------
Note: You can override the following SETDEF parameter.
See SETDEF subcommand — set defaults.

              [TEST | NOTEST ]

Parameters

EXCLUDE(name[:name]…) or NOEXCLUDE

Controls optional analysis performed by IPCS.

Using a single name explicitly designates a single type of analysis. Names can be 1-31 characters in length. They must begin with a letter or the characters $, @, or #. The same characters can be used in the remaining positions and decimal digits.

You are not limited to the names specified in Table 12. If you designate a name that is not supported by the current release, the name is recorded but has no effect on processing by IPCS.

Using name:name describes all types of analysis that collate within the range described. For example, the range A:B, excludes all types of analysis for which the name begins with either the letter A or the letter B.

Any list that you enter will be edited before being displayed by the LIST option of this subcommand or by the EVALPROF subcommand. The edited list is shown after it has been sorted and edited for efficient searching incorporating merging overlapping ranges. The implementation limits this list to 48 ranges.

Table 1 describes the naming conventions for the names supported by z/OS® R7 MVS™ IPCS.

Table 1. EXCLUDE parameter naming conventions
Name	Meaning
ANALYZEexit-name	The combination of the prefix ANALYZE and a suffix matching the name of an ANALYZE exit excludes that exit from the process of gathering contention data. This pertains to all places within IPCS where contention analysis may be performed, not only the ANALYZE subcommand.
WHERECSVCOMMON	Excludes WHERE processing that forces common area modules into the IPCS storage map before searching for associations.
WHERECSVPRIVATE	Excludes WHERE processing that forces private area modules into the IPCS storage map before searching for associations.
WHEREIGVPRIVATE	Excludes WHERE processing that forces private area pages for virtual storage manager subpools into the IPCS storage map before searching for associations.

LINESIZE(nnn) or NOLINESIZE

Controls the width of variable-width reports generated by IPCS. IPCS. LINESIZE limits the width to nnn. Specify nnn in decimal ([+]nnn), hexadecimal (X'['X'+'X']xxx'), or binary (B'['B'+'B']bbb') notation. The minimum line size is 78 and the maximum is 250.

If variable-width reports are sent to any medium that is narrower than nnn characters, IPCS limits the output lines of the report to the width of the medium or 78 characters, whichever is larger.

NOLINESIZE specifies that variable-length reports use the full width of the medium to which they are written.

NOLINESIZE is equivalent to LINESIZE(250). NOLINESIZE is the default.

PAGESIZE(nnn) or NOPAGESIZE

Controls the number of lines per page in reports generated by IPCS. PAGESIZE specifies the number of lines per page as nnn. Specify nnn in decimal ([+]nnn), hexadecimal (X'['X'+'X']xxx'), or binary (B'['B'+'B']bbb') notation. A nnn less than 3 is equivalent to NOPAGESIZE. The maximum page size is 2³¹-1.

IBM® recommends that you specify the number of lines that will fit on the forms typically used at your installation.

IPCS can generate normal, ascending page numbers if the printed output consumes less than 2³² lines of output medium. If you use a large PAGESIZE, the page number will wrap back to zero once the maximum is reached.

IPCS obtains the number of lines per page for the IPCS print output data set by checking the following in order:

The PAGESIZE specified on the PROFILE subcommand.
The PAGESIZE specified in the session parameters member for the IPCS session. (If PROFILE NOPAGESIZE is in effect, IPCS checks here first.)
When neither of the preceding is available, IPCS uses a default of 60 lines per page.

NOPAGESIZE specifies that a default not be established for the number of lines per page for the IPCS print data set. IPCS uses the PAGESIZE specified in the session parameters member or a default of 60 lines per page.

Note: Entering PROFILE NOPAGESIZE does not alter the default for your current IPCS session. It becomes effective at the beginning of your next IPCS session.

NOPAGESIZE is the default.

LIST or NOLIST

Specifies if IPCS is to display your current PROFILE defaults on your terminal regardless of the current value for the TERMINAL parameter.

LIST specifies that the subcommand is to display all of the default values and parameters that are in effect. For an example, see Figure 1.

NOLIST specifies that the subcommand not display the default values and parameters.

If you enter PROFILE without any parameters, the default is LIST. If you omit LIST and NOLIST but specify any other parameter, the default is NOLIST.

STACK(DUPLICATES | NODUPLICATES)

Controls duplication of stack entries for your current IPCS session and for future IPCS sessions that use the same dump directory.

STACK(DUPLICATES) allows stack entries to be duplicated.

STACK(NODUPLICATES) suppresses duplication of stack entries.

Note:

To be considered a duplicate, a stack entry must have all the same attributes, including remarks, as an existing entry.
Specifying NODUPLICATES will not affect duplicate entries created as a result of:
- The EQUATE subcommand and primary commands
- The RUNCHAIN subcommand
- The I and R line commands issued from the IPCS dialog BROWSE option pointer panel
- From the BROWSE option pointer panel, editing that overstrikes a pointer stack entry
No messages result when duplicate entries are suppressed. The request is considered satisfied without action if the entry already exists.

Return Codes
See Standard subcommand return codes for a description of the return codes produced by the PROFILE subcommand.
Example: Change your line, page, and stack defaults.
- Action
```
COMMAND ===> profile linesize(78) pagesize(90) stack(duplicates) list
```
- Result
  You normally use a graphics terminal with a physical screen width of 80 characters but with an actual display screen of 78 characters. LINESIZE (78) tells IPCS to produce variable-width reports with a line length of 87, regardless of whether the report output is directed to your terminal or to the print data set.
  
  Each printed page contains 90 lines of data.
  
  By specifying STACK(DUPLICATES), you authorize IPCS to add entries to the pointer stack that have exactly the same attributes as other entries in the pointer stack.
  
  The LIST parameter displays the following:
```
/*---------------------- IPCS Profile Data ------------------------*/
PROFILE   LINESIZE(78)        /* Limit for variable-width reports  */
PROFILE   PAGESIZE(90)        /* Line limit for print file pages   */
PROFILE   STACK(DUPLICATES)   /* Duplicate stack entry screening   */
```