GDDM uses file names to refer to all the partitioned data sets and
sequential destinations, with the exception of:
- The Master Print Queue and intermediate sequential data sets that are
used in the processing of queued printer output.
- (Optionally, in the absence of appropriate file names):
High-resolution image files used in the processing of family-4
devices.
The file names used are as defined in Table 15. They can be changed, if
required, after installation, by specifying new values in GDDM's external
defaults, as described in the GDDM System Customization and Administration
book.
The user should ensure that the required file names are allocated to
suitable data sets or destinations before GDDM is called. The data sets
or destinations should have Data Control Block (DCB) characteristics as
shown in Table 15. The DCB characteristics for the data sets that contain
GDDM-IMD's generated application data structures (file name ADMGNADS) and
export files (file name ADMIFMT) are given in the GDDM Interactive Map
Definition book.
If necessary, GDDM supplies default DCB characteristics when output data
sets are first opened.
Required file names can be allocated to the selected data sets or
destinations using the TSO ALLOCATE command. Or, the file names can be
allocated by DD statements in the user's TSO logon procedure, or by
dynamic allocation routines in the application program.
GDDM uses dynamic allocation to refer to the Master Print Queue and
associated intermediate sequential data sets. The data-set names used
include a qualifier that is defined in the current GDDM external defaults.
This can be changed, if required, after installation, as described in the
GDDM System Customization and Administration book. Or, the file name
ADMPRNTQ can be used to identify a Master Print Queue data set other than
that defined by the current GDDM external defaults.
The intermediate sequential data sets are allocated with a space
allocation that is defined in the TSOS99S option in the current GDDM
external defaults. The default allocation is equivalent to
SPACE=(13030,(57,57)). If required, this can be changed after
installation, as described in the table of external defaults in the GDDM
Base Application Programming Reference book.
Dynamic allocation is also used if a print request has been specified to
go directly to JES - by means of the PRINTDST processing option; see the
description of GDDM print utilities in the GDDM Base Application
Programming Reference book.
GDDM also uses dynamic allocation to refer to high-resolution image files
(for family-4 output) and CGM files, unless suitable file names were
previously allocated.
|
|
|
|
|
|
| Table 15. GDDM data-set characteristics for TSO |
Type of
Data
|
GDDM
default
file name
|
Data set
type
|
DCB characteristics |
Record
format
(RECFM) |
Record
length
(LRECL) |
Block
size
(BLKSIZE) |
Symbol sets
|
ADMSYMBL
|
Partitioned
|
400
|
| FB |
400*n |
Pictures
|
ADMSAVE
|
Partitioned
|
400
|
| FB |
400*n |
Generated
mapgroups |
ADMGGMAP
|
Partitioned
|
400
|
| FB |
400*n |
GDF files
|
ADMGDF
|
Partitioned
|
400
|
| FB |
400*n |
 | GIF output
| |
| -
| |
| Sequential
| |
|
| FB |
| 80
| |
|
| 80*n |
4250 fonts
(Note 3)
|
FONT4250
|
Partitioned
|
V |
2052
(includes
RDW)
|
LRECL+4 |
VB
|
>=
LRECL+4 |
4250 code
pages
(Note 3)
|
FONT4250
|
Partitioned
|
V |
2052
(includes
RDW)
|
LRECL+4 |
VB
|
>=
LRECL+4 |
Object
modules
|
ADMDECK
|
Sequential
data sets
or SYSOUT
classes |
F |
80
|
80 |
FB
|
80*n
|
System
Printer
Output
|
ADMLIST
|
Sequential
data sets
or SYSOUT
classes |
VA |
>= 142
(Notes 1
and 2)
|
LRECL+4 |
VBA
|
>=
LRECL+4 |
AFPDS and
CDPF (4250)
data stream
|
ADMCOLn
or
ADMIMAGE
(optional)
|
Sequential
data sets
|
V
|
2004 (for
CDPF)
8202 (for
AFPDS) |
LRECL+4
|
VBM
|
2004 (for
CDPF)
8202 (for
AFPDS)
(excludes
RDW) |
>=
LRECL+4
|
Master
print queue
|
ADMPRNTQ
(optional)
|
Direct
access data
set |
(Data set attributes provided
when data set is allocated
dynamically by GDDM) |
Queued
printer
files |
(Assigned
by GDDM)
|
Sequential
data sets
|
FBM
|
80
|
3200
|
GL plotter
files
|
(none)
|
Sequential
or
partitioned
|
F |
<=8000
|
LRECL |
| FB |
LRECL*n |
| V |
LRECL+4 |
| VB |
LRECL+4 |
Trace
records
|
ADMTRACE
|
Sequential
data sets
or SYSOUT
classes
|
VA |
>= 125 |
LRECL+4 |
VBA
|
>= 125
(includes
RDW) |
>=
LRECL+4
|
External
default
files
|
ADMDEFS
|
Sequential
data sets
|
F |
<= 256
|
LRECL |
| FB |
LRECL*n |
| V |
LRECL+4 |
VB
|
>=
LRECL+4 |
Image files
|
ADMIMG
|
Partitioned
|
F |
400
|
400 |
| FB |
400*n |
Image
projection
files |
ADMPROJ
|
Partitioned
|
F |
400
|
400 |
| FB |
400*n |
CDPDS
|
LISTCDP
|
Sequential
data sets
|
V |
<= 8200
|
LRECL+4 |
VB
|
>=
LRECL+4 |
CGM files
(input)
|
(none)
|
Sequential
or
Partitioned
|
F |
<=8000
|
LRECL |
| FB |
LRECL*n |
| V |
LRECL+4 |
VB
|
>=
LRECL+4 |
CGM files
(output)
|
(none)
|
Sequential
|
F |
400
|
400 |
| FB |
400*n |
CGM
Profiles
|
ADMCGM
|
Partitioned
|
F |
<=256
|
LRECL |
| FB |
LRECL*n |
| V |
LRECL+4 |
| VB |
>=LRECL+4 |
Notes:
1. The logical record length specified for files allocated for System
Printer Output should be sufficient to contain the 4-byte Record
Descriptor Word (RDW), the ASA control character, any Translation
Reference Character (TRC) for 3800 devices, and the maximum number of
columns for the type of System Printer selected by the application.
The value 142 is adequate for any of the System Printer device
characteristic tokens distributed with GDDM.
2. The output for all 3800 devices should contain table reference
characters (TRCs). Consequently, the parameter DCB=OPTCD=J must be
included in the output JCL. Additional parameters such as CHARS,
FLASH, or FORMS may be required. For more information, see the OS/VS2
MVS JCL manual.
3. 4250 printer fonts and code pages are referenced by GDDM and are
supplied as part of the 4250 typographical fonts licensed programs
(program numbers 5771-AAA through 5771-AAW, and 5771-ACx, where x
varies).
In TSO foreground operation, GDDM allows the unit specification for
dynamically allocated data sets to be defaulted from the TSO user
attribute data set (UADS).
In TSO Batch or MVS Batch, GDDM uses a unit specification taken from the
TSOS99U option in the current GDDM external defaults. The default
specification is "SYSDA". If required, this can be changed after
installation, as described in the table of external defaults in the GDDM
Base Application Programming Reference book.
|
GDDM V3R2 Base Application Programming Guide
Copyright IBM Corporation 1990, 2012