The installation procedure places many samples in the <hlq>.CNTL data set. If a sample is provided for a configuration task, use it as a starting point for your configuration. Usually you need to edit the sample, replacing provided information with information that is unique to your system.
The following table summarizes the samples that are provided for Mainframe Access.
| MEMBER | DESCRIPTION |
|---|---|
| ACCESS | List used to restrict access to Mainframe Access consisting of the IP addresses of connecting clients. The access list also contains the list of user IDs that are authorized to access the Mainframe Access administration functions through the Web browser interface. You should add the IP addresses and user IDs for your system; see the section Editing Access List Definitions. |
| AUDIT | JCL for creating and initializing a Mainframe Access audit log data set. The audit log is a VSAM key sequenced data set (KSDS). You should edit the sample to include JOB card information, data set names and a volume serial number. |
| AUDRPT | JCL for running the Mainframe Access audit log report program to list the contents of the audit log data set. You should edit the sample to include JOB card information and data set names. |
| FRESTORE | A copy of the FRESTORE job for reference purposes. This job was originally transferred from CD to the <hlq>.UPLOAD data set during installation. The job was customized and submitted to allocate the permanent Mainframe Access data sets and restore the data set content from other uploaded files. |
| GTFCNTL | Input control statements referenced by the sample JCL procedure in member MFAGTF. |
| INSTALL | A copy of the installation upload instructions for reference purposes. These are the instructions that describe how to allocate the <hlq>.UPLOAD data set and transfer the CD content into that data set. |
| MFA | JCL for executing Mainframe Access. You should edit the sample to include your data set names. This JCL contains references to the ACCESS, PARMS and SERVERS sample members. |
| MFAAS | JCL for executing a Mainframe Access Application Server. Application servers are auxiliary address spaces that process specific types of client requests such as Endevor transactions. You should edit the sample to include your data set names. This JCL contains a reference to the PARMSAS sample member. |
| MFAGTF | JCL for running IBM's Generalized Trace Facility (GTF). GTF provides high-performance recording of diagnostic data and can be useful during problem determination. You should edit the sample to include your data set names. |
| MFANLS | JCL for re-compiling the default code page that may be configured at a client workstation. This is equivalent to the MFLSCTRN load module of Mainframe Access Version 2. During installation the default is set to use code pages E037/A437 for EBCDIC/ASCII translation. The sample JCL contains instructions for changing the default code pages selected by installation. |
| MFAS | JCL for executing the Mainframe Access Data Connect server. You should edit the sample to include your data set names. |
| MFAVTAM | Definition of VTAM applications for Mainframe Access, Mainframe Access Data Connect, ES/MSS and Remote IMS Server. You can edit the sample to include your own ACB names and network names (see the section VTAMLST Definitions). |
| PARMS | Parameters that are read when Mainframe Access is initialized. The sample JCL for executing Mainframe Access refers to this member for parameter input. You will need to edit some of these parameters. For full details see the section Editing Mainframe Access Parameters . |
| PARMSAS | Parameters that are read when a Mainframe Access Application Server address space initializes. The sample JCL MFAAS, for executing a Mainframe Access Application Server, refers to this member for parameter input. You will need to edit some of these parameters. For full details see the section Editing Mainframe Access Parameters . |
| PVSUFFX | JCL for executing a migration tool which extracts a text definition from the MFLSCPAN load module of Mainframe Access Version 2. For full details see the section Panvalet in Appendix C. |
| SERVERS | Definitions that describe the z/OS subsystems that will be providing service in response to client requests. The servers are your IMS and CICS subsystems, the Mainframe Access Data Connect server and ES/MSS servers. You must edit the sample to include information specific to your servers and also coordinate the information with definitions in the client packages. |
| TSOXMIT | Sample job that uses TSO XMIT to package diagnostic data for transmission. |
| UPQUICK | A copy of the quick configuration instructions for reference purposes. These are the instructions that describe how to quickly configure z/OS and Mainframe Access to create an operational Mainframe Access server system. These same instructions are reiterated in the Quick Configuration section. |