HLASM Language Reference
HLASM Language Reference HLASM Language Reference
&SYSPARM System Variable Symbol Notes: 1. The value of the type attribute of &SYSOPT_XOBJECT (T'&SYSOPT_XOBJECT) is always N. 2. The value of the count attribute (K'&SYSOPT_XOBJECT) is always 1. &SYSPARM System Variable Symbol The &SYSPARM system variable is assigned a read-only value from the assembler option SYSPARM. It is treated as a global-scope SETC symbol in a source module except that its value cannot be changed. (Refer to chapter 3 of the Programmer's Guide for information on assembler options.) Notes: 1. The largest value that &SYSPARM can hold is 1024 characters. However, if the PARM field of the EXEC statement is used to specify its value, the PARM field restrictions reduce its maximum possible length. 2. No values are substituted for variable symbols in the specified value, however, on MVS and VSE, you must use double ampersands to represent a single ampersand. 3. On MVS and VSE, you must use two single quotation marks to represent a single quotation mark, because the entire EXEC PARM field is enclosed in single quotation marks. 4. If the SYSPARM assembler option is not specified, &SYSPARM is assigned the default value that was specified when the assembler was installed on your system. If a default value for SYSPARM was not specified when the assembler was installed on your system, &SYSPARM is assigned a value of the null character string. 5. The value of the type attribute of &SYSPARM (T'&SYSPARM) is U, unless &SYSPARM is assigned a null value, in which case the value of the type attribute is O. 6. The value of the count attribute (K'&SYSPARM) is the number of characters assigned as a value to &SYSPARM. If &SYSPARM is assigned a null character string, the value of the count attribute is 0. 7. If the SYSPARM option is passed to the assembler via the ASMAOPT file (CMS and MVS) or Librarian member (VSE) and the option contains imbedded spaces, it must be enclosed in quotes. &SYSPRINT_DSN System Variable Symbol Use &SYSPRINT_DSN in a macro definition to obtain the name of the data set to which the assembler writes the assembler listing. The local-scope system variable symbol &SYSPRINT_DSN is assigned a read-only value each time a macro definition is called. When the assembler runs on the MVS operating systems, the value of the character string assigned to &SYSPRINT_DSN is always the value stored in the JFCB for SYSPRINT. If SYSPRINT is allocated to DUMMY, or a NULLFILE, the value in &SYSPRINT_DSN is NULLFILE. 286 HLASM V1R5 Language Reference
&SYSPRINT_DSN System Variable Symbol When the assembler runs on the CMS component of the VM operating systems, the value of the character string assigned to &SYSPRINT_DSN is determined as follows: Figure 72. Contents of &SYSPRINT_DSN on CMS SYSPRINT Allocated To: CMS file Dummy file (no physical I/O) Printer Labeled tape file Contents of &SYSPRINT_DSN: The 8-character filename, the 8-character filetype, and the 2-character filemode of the file, each separated by a space DUMMY PRINTER The data set name of the tape file Unlabeled tape file TAPn, where n is a value from 0 to 9, or A to F. Terminal TERMINAL When the assembler runs on VSE, the value of the character string assigned to &SYSPRINT_DSN is determined as follows: Figure 73. Contents of &SYSPRINT_DSN on VSE SYSLST Assigned To: Contents of &SYSPRINT_DSN: Disk file (not for dynamic partitions) The file-id Printer SYSLST Labeled tape file The file-id of the tape file Unlabeled tape file SYSLST Examples: On MVS, &SYSPRINT_DSN might be assigned a value such as: IBMAPC.IBMAPCA.JOB6734.D12.? On CMS, &SYSPRINT_DSN might be assigned a value such as: SAMPLE LISTING A1 Notes: 1. If the LISTING user exit provides the listing data set information then the value in &SYSPRINT_DSN is the value extracted from the Exit-Specific Information block described in the HLASM Programmer's Guide. 2. The value of the type attribute of &SYSPRINT_DSN (T'&SYSPRINT_DSN) is always U. 3. The value of the count attribute of &SYSPRINT_DSN (K'&SYSPRINT_DSN) is equal to the number of characters assigned as a value to &SYSPRINT_DSN. Chapter 7. How to Specify Macro Definitions 287
- Page 256 and 257: Part 3. Macro Language &SYSDATC Sys
- Page 258 and 259: Introduction to Macro Language Chap
- Page 260 and 261: Introduction to Macro Language The
- Page 262 and 263: Introduction to Macro Language Macr
- Page 264 and 265: MACRO and MEND Statements The assem
- Page 266 and 267: Prototype Statement Macros that are
- Page 268 and 269: Model Statements generated from tha
- Page 270 and 271: Model Statements ▌5▐ ▌6▐
- Page 272 and 273: Model Statements Notes: 1. You can
- Page 274 and 275: Positional Parameters Symbolic para
- Page 276 and 277: Processing Statements Processing St
- Page 278 and 279: AREAD Instruction Assign Local Time
- Page 280 and 281: COPY Instruction sequence_symbol is
- Page 282 and 283: System Variable Symbols System Vari
- Page 284 and 285: &SYSADATA_MEMBER System Variable Sy
- Page 286 and 287: &SYSCLOCK System Variable Symbol &S
- Page 288 and 289: &SYSECT System Variable Symbol depe
- Page 290 and 291: &SYSIN_MEMBER System Variable Symbo
- Page 292 and 293: &SYSJOB System Variable Symbol &SYS
- Page 294 and 295: &SYSLIN_DSN System Variable Symbol
- Page 296 and 297: &SYSLIST System Variable Symbol The
- Page 298 and 299: &SYSLOC System Variable Symbol To
- Page 300 and 301: &SYSM_SEV System Variable Symbol &S
- Page 302 and 303: &SYSNDX System Variable Symbol The
- Page 304 and 305: &SYSOPT_DBCS System Variable Symbol
- Page 308 and 309: &SYSPRINT_MEMBER System Variable Sy
- Page 310 and 311: &SYSPUNCH_MEMBER System Variable Sy
- Page 312 and 313: &SYSSTEP System Variable Symbol Not
- Page 314 and 315: &SYSTERM_DSN System Variable Symbol
- Page 316 and 317: &SYSTIME System Variable Symbol Not
- Page 318 and 319: Macro Instruction Format sequence_s
- Page 320 and 321: Macro Instruction Format Operand En
- Page 322 and 323: Macro Instruction Format When you n
- Page 324 and 325: Sublists in Operands the order in w
- Page 326 and 327: Sublists in Operands &SYSLIST( n,m)
- Page 328 and 329: Values in Operands Notes: 1. Spaces
- Page 330 and 331: Values in Operands Parentheses In m
- Page 332 and 333: Inner and Outer Macro Instructions
- Page 334 and 335: Levels of Macro Call Nesting When t
- Page 336 and 337: Levels of Macro Call Nesting System
- Page 338 and 339: How to Write Conditional Assembly I
- Page 340 and 341: SET Symbols SET Symbol Specificatio
- Page 342 and 343: SET Symbols Figure 86 (Page 3 of 3)
- Page 344 and 345: Data Attributes this example indica
- Page 346 and 347: Data Attributes variable_symbol is
- Page 348 and 349: Data Attributes The value of an att
- Page 350 and 351: Data Attributes The following attri
- Page 352 and 353: Data Attributes Assembler gives a t
- Page 354 and 355: Data Attributes The scale attribute
&SYSPARM System Variable Symbol<br />
Notes:<br />
1. The value of the type attribute of &SYSOPT_XOBJECT<br />
(T'&SYSOPT_XOBJECT) is always N.<br />
2. The value of the count attribute (K'&SYSOPT_XOBJECT) is always 1.<br />
&SYSPARM System Variable Symbol<br />
The &SYSPARM system variable is assigned a read-only value from the assembler<br />
option SYSPARM. It is treated as a global-scope SETC symbol in a source module<br />
except that its value cannot be changed. (Refer to chapter 3 of the Programmer's<br />
Guide for information on assembler options.)<br />
Notes:<br />
1. The largest value that &SYSPARM can hold is 1024 characters. However, if<br />
the PARM field of the EXEC statement is used to specify its value, the PARM<br />
field restrictions reduce its maximum possible length.<br />
2. No values are substituted for variable symbols in the specified value, however,<br />
on MVS and VSE, you must use double ampersands to represent a single<br />
ampersand.<br />
3. On MVS and VSE, you must use two single quotation marks to represent a<br />
single quotation mark, because the entire EXEC PARM field is enclosed in<br />
single quotation marks.<br />
4. If the SYSPARM assembler option is not specified, &SYSPARM is assigned the<br />
default value that was specified when the assembler was installed on your<br />
system.<br />
If a default value for SYSPARM was not specified when the assembler was<br />
installed on your system, &SYSPARM is assigned a value of the null character<br />
string.<br />
5. The value of the type attribute of &SYSPARM (T'&SYSPARM) is U, unless<br />
&SYSPARM is assigned a null value, in which case the value of the type<br />
attribute is O.<br />
6. The value of the count attribute (K'&SYSPARM) is the number of characters<br />
assigned as a value to &SYSPARM. If &SYSPARM is assigned a null character<br />
string, the value of the count attribute is 0.<br />
7. If the SYSPARM option is passed to the assembler via the ASMAOPT file<br />
(CMS and MVS) or Librarian member (VSE) and the option contains imbedded<br />
spaces, it must be enclosed in quotes.<br />
&SYSPRINT_DSN System Variable Symbol<br />
Use &SYSPRINT_DSN in a macro definition to obtain the name of the data set to<br />
which the assembler writes the assembler listing.<br />
The local-scope system variable symbol &SYSPRINT_DSN is assigned a read-only<br />
value each time a macro definition is called.<br />
When the assembler runs on the MVS operating systems, the value of the<br />
character string assigned to &SYSPRINT_DSN is always the value stored in the<br />
JFCB for SYSPRINT. If SYSPRINT is allocated to DUMMY, or a NULLFILE, the<br />
value in &SYSPRINT_DSN is NULLFILE.<br />
286 <strong>HLASM</strong> V1R5 <strong>Language</strong> <strong>Reference</strong>