Syntax: FONTREG Procedure

Interaction: If no statements are specified, then PROC FONTREG searches for TrueType font files in the directory that is indicated in the FONTSLOC= SAS system option.

Tip: If more than one statement is specified, then the statements are executed in the order in which they appear. You can use the same statement more than once in a single PROC FONTREG step.

See FONTREG Procedure in SAS Companion for z/OS

PROC FONTREG < option(s) >;

• FONTFILE file < file >;

• FONTPATH directory < directory >;

• TRUETYPE directory < directory >;

• TYPE1 directory < directory >;

Operating Environment Information: For z/OS sites that do not use the hierarchical file system (HFS), only the FONTFILE statement is supported. See FONTREG Procedure in SAS Companion for z/OS for details.

PROC FONTREG Statement

PROC FONTREG < option(s) >;

Options

MODE=ADD REPLACE ALL

• specifies how to handle new and existing fonts in the SAS registry:

• ADD

  • add fonts that do not already exist in the SAS registry. Do not modify existing fonts.

• REPLACE

  • replace fonts that already exist in the SAS registry. Do not add new fonts.

• ALL

  • add new fonts that do not already exist in the SAS registry and replace fonts that already exist in the SAS registry.

• Default: ADD

  Featured in: Example 3 on page 427

MSGLEVEL=VERBOSE NORMAL TERSE NONE

• specifies the level of detail to include in the SAS log:

• VERBOSE

  • SAS log messages include which fonts were added, which fonts were not added, and which fonts were not understood, as well as a summary that indicates the number of fonts that were added, not added, and not understood .

• NORMAL

  • SAS log messages include which fonts were added, and a summary that indicates the number of fonts that were added, not added, and not understood.

• TERSE

  • SAS log messages include only the summary that indicates the number of fonts that were added, not added, and not understood.

• NONE

  • No messages are written to the SAS log, except for errors (if encountered ).

  • Default: TERSE

  • Featured in: Example 2 on page 426

• NOUPDATE

  • specifies that the procedure should run without actually updating the SAS registry. This option enables you to test the procedure on the specified fonts before modifying the SAS registry.

• USESASHELP

  • specifies that the SAS registry in the SASHELP library should be updated. You must have write access to the SASHELP library in order to use this option. If the USESASHELP option is not specified, then the SAS registry in the SASUSER library is updated.

FONTFILE Statement

Specifies one or more font files to be processed .

Featured in: Example 1 on page 425

FONTFILE file < file >;

Argument

file

• is the complete pathname to a font file. If the file is recognized as a valid font file, then the file is processed. Each pathname must be enclosed in quotation marks. If you specify more than one pathname, then you must separate the pathnames with a space.

FONTPATH Statement

Specifies one or more directories to be searched for valid font files to process.

Featured in: Example 2 on page 426

FONTPATH directory < directory >;

Argument

directory

• specifies a directory to search. All files that are recognized as valid font files are processed. Each directory must be enclosed in quotation marks. If you specify more than one directory, then you must separate the directories with a space.

TRUETYPE Statement

Specifies one or more directories to be searched for TrueType font files.

Featured in: Example 3 on page 427

TRUETYPE directory < directory >;

Argument

directory

• specifies a directory to search. Only files that are recognized as valid TrueType font files are processed. Each directory must be enclosed in quotation marks. If you specify more than one directory, then you must separate the directories with a space.

TYPE1 Statement (Experimental)

Specifies one or more directories to be searched for valid Type 1 font files.

TYPE1 directory < directory >;

CAUTION:

• TYPE1 is an experimental statement that is available in SAS 9.1. Do not use this statement in production jobs.

Argument

directory

• specifies a directory to search. Only files that are recognized as valid Type 1 font files are processed. Each directory must be enclosed in quotation marks. If you specify more than one directory, then you must separate the directories with a space.