CRTFNTRSC (Create Font Resources)

CRTFNTRSC Command syntax diagram

 

Purpose

The Create Font Resources (CRTFNTRSC) command creates a font resource object from a physical file. The physical file contains the font resource information. The font resource information, can, for example, come from an S/370 host system and be in the Systems Application Architecture* (SAA) format. Depending on the type of information processed by the CRTFNTRSC command, the results are either a font character set, a code page, or a coded font.

 

Required Parameters

FNTRSC

Specifies the qualified name of the font resource being created.

The name of the font resource can be qualified by one of the following library values:

*CURLIB: The font resource is created in the current library for the job. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library where the font resource is created.

font-resource-name: Specify the name of the font resource being created.

FILE

Specifies the qualified name of the database file in which the font resource data resides.

The name of the database file can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

file-name: Specify the name of the file to create the database file.

 

Optional Parameters

MBR

Specifies the name of the file member used to create the font resource.

*FNTRSC: The name of the file member that contains the input data is the same as the font resource being created.

member-name: Specify the name of the file member that contains the font resource.

REPLACE

Specifies whether the page definition is replaced.

*YES: The page definition is replaced.

*NO: No replacement occurs.

AUT

Specifies the authority given to users who do not have specific authority to the font resources, who are not on an authorization list, and whose user group has no specific authority to the font resources.

*LIBCRTAUT: The public authority for the font resources is taken from the value on the CRTAUT parameter of the target library (the library that is to contain the font resources). The public authority is determined when the font resources is created. If the CRTAUT value for the library changes after the font resources is created, the new value does not affect any existing objects.

*CHANGE: The user can perform all operations on the object except those limited to the owner or controlled by object existence authority and object management authority. The user can change and perform basic functions on the object. Change authority provides object operational authority and all data authority.

*ALL: The user can perform all operations except those limited to the owner or controlled by authorization list management authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the font resources.

*USE: The user can perform basic operations on the font resources, such as running a program or reading a file. The user cannot change the font resources. *USE authority provides object operational authority, read authority, and execute authority.

*EXCLUDE: The user cannot access the font resources.

authorization-list-name: Specify the name of the authorization list used.

TEXT

Specifies the text that briefly describes the program and its function. More information on this parameter is in Commonly used parameters.

*MBRTXT: The text is taken from the file member used to create the font resource. Text can be added or changed for a database source member by using either the Add Physical File Member (ADDPFM) command or the Change Physical File Member (CHGPFM) command. If the source file is an inline file or a device file, the text is blank.

*BLANK: No text is specified.

'description': Specify no more than 50 characters of text, enclosed in apostrophes.

Example for CRTFNTRSC

CRTFNTRSC  FNTRSC(MYLIB/GOTHIC12)  FILE(*LIBL/FONTRSCS)
  MBR(*FNTRSC)  AUT(*USE)  TEXT('Gothic Font 12 Pitch')

This command creates font resource GOTHIC12 in MYLIB. Source file FONTRSCS, in the user's library list, with member GOTHIC12 is used as input. Specifying *USE for the AUT parameter allows other users to access GOTHIC12, but not to change it. The text describes the font resource.

Error messages for CRTFNTRSC

*ESCAPE Messages

CPF2283

Authorization list &1 does not exist.

CPF8056

File &1 in &2 not a physical file.

CPF88C1

Printer resource type &1 &2 was not created in library &3.

CPF9809

Library &1 cannot be accessed.

CPF9810

Library &1 not found.

CPF9812

File &1 in library &2 not found.

CPF9822

Not authorized to file &1 in library &2.

CPF9845

Error occurred while opening file &1.

CPF9846

Error while processing file &1 in library &2.

CPF9847

Error occurred while closing file &1 in library &2.

CPF9870

Object &2 type *&5 already exists in library &3.