Macro Language Reference > Macros > Document > tparpref
  
tparpref
Description
Sets the preferences for an SGML document.
 
This macro was replaced in PTC ALD version 7 by the tsgm* macros and is included only for backwards compatibility.
Syntax
tparpref 0:L 1:L filename:s 2:L stype:n sname:s dtype:n dname:s case:n docsave:n
3:L parsetype:n replace:n? ( suppress:n linkfile:s ) 4:L filename:s 5:L warnings:n
showwarnings:n maxerrors:n 6:L filename:s overwrite:n 7:L streamname:s
filename:s options:s scan:n assign:n 8:L streamname:s filename:s
0
Reset the customer/document default values.
1
Indicate that a customer configuration file containing the document-wide settings for SGML is to be loaded.
filename
The name of the customer configuration file to be loaded: the default value is sgmlcon.3ag
2
Indicate that preferences for the parsing options are to be defined. Pre v7 settings can be defined via the Legacy Settings dialog box.
stype
The location of the SGML declaration:
0
Use the default SGML declaration
1
Use an external file as the SGML declaration (default value)
2
Use an existing stream as the SGML declaration
3
Load an SGML declaration file into a stream
sname
The name of the SGML declaration. This will be either a stream name or a file name depending on the value of the stype parameter.
dtype
The location of the DTD:
0
DTD is specified by the <!DOCTYPE..> statement at the top of the SGML stream.
1
Use an external file as the DTD (default value)
2
Use an existing stream as the DTD
3
Load a DTD file into a stream
dname
The name of the DTD: will be either a stream name or a file name depending on the value of the dtype parameter.
case
Whether or not to use case sensitive tag names:
0
Use case insensitive tag names (default value)
1
Use case sensitive tag names
You can also specify that you want tag names to be case-sensitive under the Tags tab in the Document Preferences dialog box.
docsave
Whether or not to save the customer preferences with the document:
0
Do not save customer preferences with document (default value)
1
Save customer preferences with document
3
Indicate that the type of parser operation is to be defined
parsetype
The type of parser operation to run:
0
Test the DTD file only for SGML compliance
1
Test the instance against the DTD for SGML compliance (default value)
2
Test the instance against the DTD for SGML compliance and create a stream "sgml_output" which will contain the expanded markup of the original SGML
3
Test the instance against the DTD for SGML compliance and create a stream "sgml_output" which will contain the transformed markup from the original SGML
replace
Whether or not to replace the original SGML stream with the output of stream"sgml_output":
0
Do not replace the original SGML stream (default value)
1
Replace the original SGML stream
suppress
Whether or not to suppress the SGML declaration and document type definition from the output stream "sgml_output":
0
Do not suppress the SGML declaration and DTD from the output stream
1
Suppress the SGML declaration and DTD from the output stream (default value)
linkfile
The name of the file containing the mapping information to allow the parser to transform the original SGML stream to another type of markup (e.g. HTML).
4
Indicate that a catalog file is to be used to specify file locations to the parser.
filename
The name of the catalog file to be used
5
Indicate that the types of warnings and error messages to be displayed are to be set up (default 3325).
warnings
1
Warn about defaulted references
2
Report duplicate entity declarations
4
Warn about undefined elements and notations
8
Warn about mixed content models that do not allow #PCDATA anywhere
16
Warn about dubious constructions in the SGML declaration
32
Warn about recommendations made in ISO 8879
64
Warn about unclosed start and end tags
128
Warn about empty start and end tags
256
Warn about net-enabling start and end tags
512
Warn about minimized start and end tags
1024
Warn about unused short reference maps
2048
Warn about parameter entities that are defined in a DTD but not used
4096
Warn about notations for which no systems identifier could be generated
showwarnings
Whether or not to display warnings:
0
Do not display warnings
1
Display warnings (default value)
maxerrors
The maximum number of errors that will be output: this has a default value of 200
6
Indicate that a customer configuration file is to be saved.
filename
The name of the customer configuration file name that will be saved. This has a default value of sgmlcon.3ag.
overwrite
Whether or not to overwrite the file filename if it already exists:
0
Do not overwrite the filename of the file
1
Overwrite the filename of the file
7
Indicate that an SGML file is to be loaded into a stream.
streamname
The name of the tag into which to load an SGML file: this should be the name of a tag that does not already exist
filename
The filename of the SGML file to be loaded
options
The required import options: these can be viewed in full on the Options tab of the Load SGML File into Stream dialog box (via macro tsgmload). This has a default value of e which means that the load process will preserve the exact markup.
scan
Whether or not to scan the incoming stream for undefined tags and entities:
0
Do not scan the incoming stream
1
Scan the incoming stream (default value)
assign
Whether or not to assign the stream streamname to a frame:
0
Do not assign the stream streamname to a frame
1
Assign the stream streamname to a frame
8
Indicate that a stream is to be saved to a file.
streamname
The name of the stream to be saved
filename
The filename to which the stream streamname is to be saved