CA Panvalet Members

This document covers the following topics:

CA Panvalet Overview

The CA Panvalet facility enables access to CA Panvalet members, which you can maintain using Natural ISPF functions.

If the member consists of job control, you can make use of the Natural ISPF macro facility. You can use all types of macro statements. Macro expansion is performed at submission time (see the SUBMIT command below). When creating a new member, you can also use the Edit macro feature to automatically create text lines which can then be modified. For details on the macro facility, see the section Macro Facility in the Natural ISPF Programmer's Guide.

To enter the CA Panvalet facility, select the PANVALET option from the Natural ISPF Main Menu. The CA Panvalet Entry Panel appears: 

   -------------------------- PANVALET - ENTRY PANEL -----------------------------
   COMMAND ===>
  
  
      Data Set Name ===>
      Member        ===>
      Language      ===>
      User          ===>
      Status        ===>
      Volume        ===>                         ( If not catalogued     )
      Password      ===>                         ( If password protected )
      Expand        ===>                         ( Expand ++include      )
      Comment       ===>
      Scan for      ===>
      Edit macro    ===>
      Node          ===> 148
  
  
  
  
  
  
   Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
         Help  Split End   Suspe Rfind Rchan Up    Down  Swap  Left  Right TOP

You can specify the CA Panvalet member you wish to maintain in the input fields and enter a function command in the command line.

Meaning of the input fields:

Field Meaning
Data Set Name Name of library in which the member resides. This field contains the name of the library last accessed. You can select any other library by overtyping the name.
Member Member name (up to ten alphanumeric characters). Leave blank or use strings and wildcards (* and _) to generate a more selective list of member names. See the subsection Selection Windows and Wildcards in the section Command Logic.
Language Language (format) of member, for example, JCL, ASMB (Assembler), COBOL, PL/1, etc.
User User code (up to four numeric digits).
Status

Status of member. Any one or a combination of the following are possible:

First character: T or P - Test/Production

Second character: A or I - Active/Inactive

Third character: E or D - Enabled/Disabled

Volume Volume serial number. Required only for uncataloged datasets.
Password Appropriate access code if dataset is protected.
Expand

Specifies expansion of ++INCLUDE statements when using any of the following commands: BROWSE, SUBMIT, PRINT, COPY, INFORMATION, EXPORT.

Possible options:

Y Perform expansion.

N No expansion is performed.

Comment Comment to appear in list of members and in the information window. You normally add a comment describing the member when creating a new one. If you type a plus sign + as last character of the comment, a window opens in which you can extend the comment text.
Scan for Selection criterion for listing CA Panvalet members: all members as specified in the above fields are listed which contain the string entered here. When you select a member from this list for EDIT or BROWSE, the cursor is placed on the first occurrence of this string in the member. Issue the RFIND command to find the next occurrence.
Edit macro Name of macro object to be used as a model for the member. The specified macro is executed and loaded into the Editor. See the section Macro Facility in the Natural ISPF Programmer's Guide for details.
Node Select Entire System Server node. Enter a question mark (?) and press ENTER to open a window in which all node numbers appear with an ACTIVE or INACTIVE status report. If you do not specify a node, the default node is assumed.

For detailed information on CA Panvalet member characteristics, see the appropriate CA Panvalet documentation.

Apart from the Data Set Name and Member fields, some other parameter fields may be mandatory when creating a new member with the EDIT function command. Which fields are required and which are optional is specified in the system configuration (see the Natural ISPF Administration Guide, or ask your system administrator). Natural ISPF prompts you for required items.

Natural ISPF provides the session command CONTROL for CA Panvalet users.

CONTROL OFF suppresses the automatic control cards passed to CA Panvalet when a member is saved. Only the edited data (which may include user-defined control cards) are sent to CA Panvalet.

The command format is: 

CONTROL  [ON]
         [OFF]

Meaning of the parameters:

Parameter Meaning
ON Re-activates the automatic control cards (default).
OFF Suppresses the automatic control cards. You can define your own control cards in the member.

You must issue the CONTROL command before opening the new Editor session.

Function Commands for CA Panvalet Members

The available function commands for CA Panvalet members are:

Command Parameter Syntax
BROWSE dataset(member) VOL=v PASSWORD=p EXPAND=Y/N NODE=id
COPY dataset(member) VOL=v PASSWORD=p EXPAND=Y/N NODE=id, object-type object-parameters, REP
DELETE dataset(member) VOL=v PASSWORD=p NODE=id 
EDIT dataset(member) LANG=l USER=u VOL=v PASSWORD=p MACRO=name NODE=id
EXPORT dataset(member) VOL=v PASSWORD=p EXPAND=Y/N NODE=id, target-environment
INFORMATION dataset(member) VOL=v PASSWORD=p EXPAND=Y/N NODE=id
LIST dataset(*_*) LANG=l USER=u ST=s VOL=v PASSWORD=p MACRO=name NODE=id
OUTPUT NODE=id
PLAY dataset(member) VOL=v PASSWORD=p NODE=id
PRINT dataset(member) VOL=v PASSWORD=p EXPAND=Y/N NODE=id, printer-name CC
RENAME dataset(member) VOL=v PASSWORD=p NODE=id, new-name
SUBMIT dataset(member) VOL=v PASSWORD=p EXPAND=Y/N NODE=id1, TARGET=id2

A full description of these commands is contained in the section Command Reference. The object parameters correspond to the input fields on the CA Panvalet Entry Panel.

Note
If you issue any of the above function commands from outside the CA Panvalet facility, you must specify the object-type parameter PAN before the object parameters.

Below are some examples of function commands using full command syntax.

Example: INFORMATION

The following screen is displayed as a result of the function command 

INFORMATION PAN SYSA.PANLIB.OPT(MYMEM)

A window opens containing information on member MYMEM in library SYSA.PANLIB.OPT: 

  --------------------------- PANVALET - ENTRY PANEL-----------------------------
  COMMAND ===>
  
  
     Data Set Name ===> MBE.COMN.SOURCE
     Member        ===>
     Language      ===>
     User      +-------------------------------------------------------------+
     Status    ! INFORMATION-PANVALET                                        !
     Volume    ! DSName  : SYSA.PANLIB.OPT                                   !
     Password  ! Member  : MYMEM                                             !
     Expand    ! Language: ASMB                                              !
     Comment   ! Status  : T   (Test/Production)                             !
     Edit macr !           A   (Active/Inactive)                             !
     Node      !           E   (Enabled/Disabled)                            !
               ! User    : 0007                                              !
               ! Level   :  24                                               !
               ! Comment : NISPF TEST PROGRAM                                !
               !-------------------------------------------------------------+
  
  
  Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
        Help  Split End   Suspe Rfind Rchan Up    Down  Swap  Left  Right Curso

The fields in the information window correspond to the fields on the CA Panvalet Entry Panel, except the Level field.

Level is the modification level of the member. When a member is created, it is assigned Level 001. The level number is increased by 1 at each update (see the appropriate CA Panvalet documentation for more information).

You can use the INFORMATION command to change certain characteristics of the member. Simply overtype the current value with the new value in the information window. The fields Member, Language, Status, User, Level and Comment are all modifiable.

Example: LIST

The following list of CA Panvalet members is displayed as the result of the command: 

LIST PAN SYSA.PANLIB.OPT(ISP*)

The list contains all members starting with ISP in the library SYSA.PANLIB.OPT: 

  LIST-PAN:SYSA.PANLIB.OPT(ISP*)------------------- Row 0 of 12 - columns 010 076
   COMMAND===>                                                    SCROLL===> CSR
     MEMBER             LVL USER LANG   STA MAINTAIN ACCESSED  BLKS STATMTS COMME
  ** ******************************** top of list *******************************
     ISPJCL1234           1 2223 JCL    TAE 21/06/90 21/06/90     1      22 Insta
     ISPPROG1             2 2223 ASMB   TAE 21/06/90 21/06/90     1     107 Test
     ISPPROG2
  1 1420 COBOL  TAE 22/06/90 22/06/90     1      17 Progr
     ISPSYSZ              1 2223 DATA   TAE 22/06/90 22/06/90     1       5 Text
  
  ** ****************************** bottom of list ******************************
  
  
  
  
  
  
  
  
  
  
  
  
  Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
        Help  Split End   Suspe Rfind Rchan Up    Down  Swap  Left  Right Curso

Meaning of the column headings:

Column Meaning
MEMBER Name of member
LVL Modification level of member
USER User code
LANG Programming language of member
STA

Status of member:

A Active

I Inactive

E Enabled

D Disabled

T Test

P Production

MAINTAIN Date of last change to member text and/or characteristics (for example, user code, comment)
ACCESSED Date of last access in read or write mode
BLKS Number of blocks occupied by member
STATMTS Number of lines in the member
COMMENT Comment describing member

To display the whole comment column, issue the Editor RIGHT command (usually assigned to PF11).

Note
The modification level, user code, language, status and comment are modifiable in the information window invoked using the INFORMATION function command (see the example of the INFORMATION command).

Line Commands for CA Panvalet Members

You can select a CA Panvalet member from a list by typing a line command in the input field preceding the member name and pressing ENTER. Each line command is an abbreviation of a function command. The available line commands are:

Line Command Corresponding Function Command
BR BROWSE
CP COPY
D DELETE
E EDIT
EX EXPORT
I INFORMATION
OT OUTPUT
PL PLAY
PR PRINT
R RENAME
SB SUBMIT

Line commands can also be used as valid abbreviations of function commands entered in the command line.

Local Commands for CA Panvalet Members

In Edit Mode:

If you display a CA Panvalet member in Editor format in EDIT mode, you can issue a local command from the Editor command line in addition to Editor commands.

The following local command is available:

Command Meaning
IMPORT Imports a PC file or Con-nect document into the CA Panvalet member (see the section Useful Features).

In List Mode:

If you display lists of CA Panvalet libraries or members in Editor format, you can issue the following local commands in addition to Editor scroll commands: ALL, LAYOUT, RELIST and SORT. For detailed information, see the corresponding subsections in the section Useful Features.

Handling CA Panvalet Control Cards

Natural ISPF provides some features for flexible handling of CA Panvalet control cards:

  • Using the expand feature, you can specify whether the ++INCLUDE statements in the member are expanded before browsing, printing, submitting, copying, exporting the member, or displaying information;

  • With the CONTROL OFF session command, you can submit the edited member to PAM#1 using the Editor SAVE command without the automatic control cards. Only the edited text, including any control cards you have added in the member are processed. You can use the OUTPUT function command to see the output of the member as processed.

On this page