Window Files

In this section:

Compiled Window Files
Window Transfer Files and Window Documentation Files
Non-FOCUS Data Sources
TTEDIT Files
HOLDSTAT Files

Window files contain the windows, menus, and related information created by Window Painter. There are three types of window files:

Compiled window files are created when a Window Painter user chooses the Create a new file option, or invokes Window Painter and specifies a window file that does not exist yet. Compiled window files are also created when a window transfer file is compiled by the WINDOW COMPILE command. Compiled window files can be executed by a Dialogue Manager -WINDOW statement, and can be edited using Window Painter.
Window transfer files are created by selecting the Create a transfer file option from the Window Painter Utilities Menu. Transfer files are uncompiled source code versions of compiled window files; they can be transferred from FOCUS running in one operating environment (for example, z/OS) to FOCUS running in another operating environment (for example, UNIX), and then edited to remove or fine tune window features not fully supported in the new environment. Transfer files can be edited using TED or IEDIT. Before they can be executed efficiently by a -WINDOW command or edited by Window Painter, they must be compiled using the WINDOW COMPILE command.
Window documentation files are created by selecting the Document a file option from the Window Painter Utilities Menu. A documentation file provides a window application developer with detailed information about the windows in a given window file. Documentation files can be edited using TED or IEDIT.

Compiled Window Files

Compiled window files are members of a data set. Before they can be created by Window Painter or by the WINDOW COMPILE command, a data set must be created with LRECL 4096 and RECFM FB, and allocated to DDNAME FMU.

Once the data set is allocated, Window Painter and the WINDOW COMPILE command will create compiled window files as required. The member name will be the window file name specified in the Window Painter session or the WINDOW COMPILE command.

Note that creating the data set is not necessary if you are creating window files to be used only in the same FOCUS session. Window Painter will temporarily allocate the data set.

Window Transfer Files and Window Documentation Files

Window transfer files and window documentation files are both members of the same data set. Before they can be created by Window Painter, the data set must be created with LRECL 80 to 132 and RECFM FB, and must be allocated to DDNAME TRF.

Once the data set is allocated, Window Painter can create window transfer files and window documentation files as needed, and transfer files can be transferred from FOCUS running in other environments as needed. Note that before transferring a file from another operating environment, you will need to allocate a new member in the TRF data set for it.

The member name for documentation files will be the window documentation file name specified in the Window Painter session. The member name for transfer files will be the window transfer file name specified in the Window Painter session, or the member name specified in the TSO ALLOCATE or DYNAM ALLOCATE command issued prior to the transfer.

Note: Creating the data set is not necessary if you are creating window transfer files and documentation files to be used only in the current FOCUS session. Window Painter will temporarily allocate the data set.

If you need to create both a documentation file and a transfer file for a given compiled window file, be sure to create these two files with different names; otherwise, the newer one will overwrite the older one in the data set.

Non-FOCUS Data Sources

How to:

Set the VSAM Addressing Mode

You can use the FOCUS query language to read non-FOCUS data sources. FOCUS can read QSAM, ISAM, VSAM files; IMS, CA-IDMS/DB, ADABAS, MODEL 204, Millennium, DB2, CA-DATACOM/DB, and Teradata tables.

The DDNAME under which you should allocate the non-FOCUS data source depends on the type of data source. You should allocate QSAM, ISAM, and VSAM files to a DDNAME that corresponds to a member name in the data set allocated to DDNAME MASTER. Database files have their own rules governing DDNAMEs.

Except with QSAM files, FOCUS needs an Interface program to read non-FOCUS data sources. To read some IMS, CA-IDMS/DB, and ADABAS database files, you must also allocate all of the files normally used with these data sources.

Syntax: How to Set the VSAM Addressing Mode

MVS VSAM SET AMODE 31

With AMODE 31, FOCSAM builds ACBs and buffers in 31-bit addresses. 31 is the default.

To determine the addressing mode that is in effect at any time, you can issue the query

MVS VSAM SET ?

which returns the following output:

(FOC1177)	SET OPTIONS - : BUFND = n / BUFNI = n / AMODE = n

TTEDIT Files

How to:

Edit a Saved TableTalk Session

When you save a TableTalk session, a command file and a session file are saved. These files are written as follows:

The command file is written as a member in the data set allocated to DDNAME FOCEXEC if it is allocated OLD or NEW. If FOCEXEC is allocated as SHR or is not allocated, the command file is written to the data set 'prefix.FOCEXEC.DATA'. If there is no 'prefix.FOCEXEC.DATA', the commands are written to a sequential data set.
The TableTalk session is written as a member in the data set allocated to DDNAME TTEDIT if it is allocated OLD or NEW. If TTEDIT is allocated as SHR or is not allocated, the session file is written to the data set 'prefix.TTEDIT.DATA'. If there is no 'prefix.TTEDIT.DATA', the session is written to a sequential data set; the session will only be available for editing by exiting TableTalk, re-entering TableTalk, and selecting Last Request.

The FOCEXEC and TableTalk session are saved in their respective data sets as the member name you specify in TableTalk.

To save and edit TableTalk sessions, allocate a data set to DDNAME TTEDIT as OLD. An allocation for TTEDIT is not needed if the data set 'prefix.TTEDIT.DATA' exists. The data set should have LRECL=80,RECFM=FB.

If you omit the file name, a list of all TTEDIT files will be displayed. Include a file name to edit a particular saved TableTalk session.

Syntax: How to Edit a Saved TableTalk Session

To edit saved TableTalk sessions, enter the command

TABLETALK EDIT [filename]

where:

filename: Is the file name you specified in the saved TableTalk session. If you omit the file name, a list of all TTEDIT files will be displayed. Include a file name to edit a particular saved TableTalk session.

HOLDSTAT Files

How to:

Specify a HOLDSTAT File

Reference:

Considerations for Creating a HOLDSTAT File

HOLDSTAT files enable you to include FOCUS DBA information and environmental comments in HOLD and PCHOLD Master Files. Member HOLDSTAT in the distributed library 'prefix.ERRORS.DATA' is the default. Alternately, you may create your own HOLDSTAT or another user-specified member in your ERRORS or MASTER data sets.

The contents of a HOLDSTAT file are automatically included in HOLD and PCHOLD Master Files when the SET HOLDSTAT command is specified to ON or to a member name. For information about the SET HOLDSTAT command, see the Developing Applications manual.

Syntax: How to Specify a HOLDSTAT File

The HOLDSTAT file may exist as a member in the ERRORS or MASTER library:

'prefix.ERRORS.DATA{(HOLDSTAT)|(membername)}'

'prefix.MASTER.DATA{(HOLDSTAT)|(membername)}'

where:

prefix: Is the high-level qualifier used at your site.
membername: Is the member name of your customized HOLDSTAT file.

Note: When FOCUS searches for the HOLDSTAT file, the MASTER DDNAME takes precedence over the ERRORS DDNAME.

A HOLDSTAT file may contain environmental comments like a file header, or the FOCUS DBA attribute, or both. The supplied HOLDSTAT member contains the following file header with Dialogue Manager system variables:

$================================================================$
$      HOLD file created on &DATE at &TOD by FOCUS &FOCREL       $
$              Database records retrieved= &RECORDS              $
$              Records in the HOLD file = &LINES                 $
$================================================================$

In the HOLD Master File, the comments appear after the FILE and SUFFIX attributes and the DBA information is appended to the end.

Reference: Considerations for Creating a HOLDSTAT File

If you create your own HOLDSTAT file, consider the following rules:

Each line of comments must begin with a dollar sign ($) in column 1.
Comments may not include user-defined variables.
List the DBA information after any comments. On separate lines, specify the keywords $BOTTOM and END, beginning in column 1, followed by the DBA attribute. The syntax is:
```
$BOTTOM
END
DBA=password,$
```
You may include other DBA attributes such as USER, ACCESS, RESTRICT, NAME, and VALUE. For information about the DBA attributes, see the Describing Data manual.