|
DataMuseum.dkPresents historical artifacts from the history of: IBM System/36 |
This is an automatic "excavation" of a thematic subset of
See our Wiki for more about IBM System/36 Excavated with: AutoArchaeologist - Free & Open Source Software. |
top - metrics - download
Length: 16128 (0x3f00)
Notes: FORM36, MEMBER_O
Names: »#HE@T36 «
└─⟦5475bb115⟧ Bits:30009795 AS/ENTRY - S/36 SYST SUPP PROG S/36 VALUE ADDED SOFTWARE PACKAGE Refer to Memo 051445 Product Number 5727SS6 Rel 05 Created 19950301 Level 01 Seq 001 of 002
└─⟦56084dc9a⟧
└─⟦this⟧ ».#HE@T36 «
FormPointer36 {name=»TRACE310«, f1=0x00, start=0x0002, length=0x05, f5=0x00, f6=0x00, f7=0x00, f8=0x00, f9=0000000000000000}
┌────────────────────────────────────────────────────────────────────────────────┐
00│ HELP FOR TRACE36 PROCEDURE Page 1 of 9 │
01│ │
02│ ╳DESCRIPTION╳ │
03│ │
04│ The TRACE36 procedure is used to collect file activity data and │
05│ provide reports based on this data. The following steps describe │
06│ how TRACE36 would be used: │
07│ │
08│ 1. Start the TRACE36 data collection (TRACE36 START). │
09│ 2. Run the job needing to be analyzed from start to end. │
10│ 3. Stop the TRACE36 data collection (TRACE36 STOP). │
11│ 4. Report on the collected data (TRACE36 REPORT). │
12│ │
13│ │
14│╳ KEYS YOU CAN USE ON TRACE36 PROCEDURE DISPLAY ╳ │
15│ │
16│ Cmd2 - Display the previous prompt │
17│ Cmd3 - Display the previous menu │
18│ Cmd7 - Exit TRACE36 procedure │
19│ │
20│ │
21│ │
22│ │
23│ Cmd3-Exit help text Roll keys-Page help text COPR IBM Corp. 1992│
24│ │
25│ │
26│ │
27│ │
└────────────────────────────────────────────────────────────────────────────────┘
FormPointer36 {name=»TRACE320«, f1=0x00, start=0x0007, length=0x08, f5=0x00, f6=0x00, f7=0x00, f8=0x00, f9=0000000000000000}
┌────────────────────────────────────────────────────────────────────────────────┐
00│ HELP FOR TRACE36 PROCEDURE Page 2 of 9 │
01│ │
02│ ╳TRACE36 option . . . . . . . . . . . . . START,STOP,REPORT ╳ │
03│ │
04│ START - Initiates the collection of TRACE36 data for any │
05│ subsequent jobs which are run. An alternate trace table │
06│ is used for the collection. Logging to disk is performed │
07│ to a file with the same name as the trace table. │
08│ │
09│ STOP - Stops the collection of TRACE36 data. The collection is │
10│ stopped by removing the alternate trace table from memory. │
11│ │
12│ REPORT - Create a report based on a TRACE36 data collection file │
13│ and output report to the system printer or a disk file. │
14│ │
15│ │
16│ │
17│ │
18│ │
19│ │
20│ │
21│ │
22│ │
23│ Cmd3-Exit help text Roll keys-Page help text COPR IBM Corp. 1992│
24│ │
25│ │
26│ │
27│ │
└────────────────────────────────────────────────────────────────────────────────┘
FormPointer36 {name=»TRACE330«, f1=0x00, start=0x000f, length=0x08, f5=0x00, f6=0x00, f7=0x00, f8=0x00, f9=0000000000000000}
┌────────────────────────────────────────────────────────────────────────────────┐
00│ HELP FOR TRACE36 PROCEDURE Page 3 of 9 │
01│ │
02│ ╳Alternate trace table name . . . . . . . . . . . . . . . . . ╳ │
03│ │
04│ Specifies the alternate trace table name. The name must be 1 to 8 │
05│ characters. The first character of the name must be a letter from │
06│ "A" through "Z" or characters "$", "#", "@", "\", and "}". The │
07│ remaining characters 2 to 8 may be represented by digits (0-9) in │
08│ addition to the letters and special characters. │
09│ │
10│ A data collection file (trace file) is created with the same name as │
11│ the alternate trace table. If an existing alternate trace TABLE has │
12│ a matching name, tracing does not start. If an existing trace FILE │
13│ has a matching name, it is reused for the current trace. If an │
14│ existing non-trace FILE has a matching name, tracing does not start. │
15│ │
16│ │
17│ │
18│ │
19│ │
20│ │
21│ │
22│ │
23│ Cmd3-Exit help text Roll keys-Page help text COPR IBM Corp. 1992│
24│ │
25│ │
26│ │
27│ │
└────────────────────────────────────────────────────────────────────────────────┘
FormPointer36 {name=»TRACE340«, f1=0x00, start=0x0017, length=0x07, f5=0x00, f6=0x00, f7=0x00, f8=0x00, f9=0000000000000000}
┌────────────────────────────────────────────────────────────────────────────────┐
00│ HELP FOR TRACE36 PROCEDURE Page 4 of 9 │
01│ │
02│ ╳Data collection file size (in blocks) . . . . . . . . . . . ╳ │
03│ │
04│ Specifies the size of the trace file. This can be from 1 to 5000 │
05│ blocks in size. The trace information automatically wraps once the │
06│ data reaches the file size limit. File wrapping may be prevented │
07│ by using a larger file size. A total of 26 and two-thirds (2/3) │
08│ operations can be logged in each file block. A total of │
09│ approximately 133,333 file operations may be logged to the maximum │
10│ size file before it will wrap. │
11│ │
12│ │
13│ ╳Alternate trace table size . . . . . . . . . . . . . 16-512 ╳ │
14│ │
15│ Specifies the size of the alternate trace table. This can be from │
16│ 16 to 512 entries. Each trace table entry requires 32 bytes so the │
17│ table size can range from 512 bytes to 16K bytes. All tables above │
18│ 56 entries (1.75K) are stored in user memory space. Larger tables │
19│ can provide improved performance since less disk operations are │
20│ required during the tracing. The default for this parameter is 56. │
21│ │
22│ │
23│ Cmd3-Exit help text Roll keys-Page help text COPR IBM Corp. 1992│
24│ │
25│ │
26│ │
27│ │
└────────────────────────────────────────────────────────────────────────────────┘
FormPointer36 {name=»TRACE350«, f1=0x00, start=0x001e, length=0x08, f5=0x00, f6=0x00, f7=0x00, f8=0x00, f9=0000000000000000}
┌────────────────────────────────────────────────────────────────────────────────┐
00│ HELP FOR TRACE36 PROCEDURE Page 5 of 9 │
01│ │
02│ ╳Alternate trace table name . . . . . . . . . . . . . . . . . ╳ │
03│ │
04│ Specifies the alternate trace table to remove, thereby halting │
05│ the logging of TRACE36 data to the data collection file (trace file) │
06│ of the same name. │
07│ │
08│ The names of active alternate trace tables can be found by using the │
09│ TRACE CRT command to access the "S/36 TRACE UTILITY" screen. The │
10│ roll keys can then be used to page through the alternate trace │
11│ tables. │
12│ │
13│ │
14│ │
15│ │
16│ │
17│ │
18│ │
19│ │
20│ │
21│ │
22│ │
23│ Cmd3-Exit help text Roll keys-Page help text COPR IBM Corp. 1992│
24│ │
25│ │
26│ │
27│ │
└────────────────────────────────────────────────────────────────────────────────┘
FormPointer36 {name=»TRACE360«, f1=0x00, start=0x0026, length=0x03, f5=0x00, f6=0x00, f7=0x00, f8=0x00, f9=0000000000000000}
┌────────────────────────────────────────────────────────────────────────────────┐
00│ HELP FOR TRACE36 PROCEDURE Page 6 of 9 │
01│ │
02│ ╳Data collection file . . . . . . . . . . . . . . . . . ╳ │
03│ │
04│ Specifies the trace file which contains TRACE36 data. This file │
05│ must not be busy with an active trace table that is logging to disk. │
06│ │
07│ │
08│ ╳Report scope . . . . . . . . . . . . . . . . . USER,JOB ╳ │
09│ │
10│ Limits report output to data from a specific user or job. │
11│ The default for this parameter is USER. │
12│ │
13│ │
14│ │
15│ │
16│ │
17│ │
18│ │
19│ │
20│ │
21│ │
22│ │
23│ Cmd3-Exit help text Roll keys-Page help text COPR IBM Corp. 1992│
24│ │
25│ │
26│ │
27│ │
└────────────────────────────────────────────────────────────────────────────────┘
FormPointer36 {name=»TRACE370«, f1=0x00, start=0x0029, length=0x07, f5=0x00, f6=0x00, f7=0x00, f8=0x00, f9=0000000000000000}
┌────────────────────────────────────────────────────────────────────────────────┐
00│ HELP FOR TRACE36 PROCEDURE Page 7 of 9 │
01│ │
02│ ╳Report scope name . . . . . . . . . . . . . . .name,ALL ╳ │
03│ │
04│ Identifies the user or job name to use in limiting the scope of the │
05│ report. Use ALL to provide a system report. If the report scope is │
06│ USER, the default for the report scope name is the current user ID. │
07│ If the report scope is JOB, the default is ALL. │
08│ │
09│ │
10│ ╳Report format . . . . . . . . . . . SUMMARY,DETAIL,BOTH ╳ │
11│ │
12│ Specifies the format of the output report. Two report formats are │
13│ supported: detail and summary. Both may be used in the same report. │
14│ The detail report provides one report line for each file operation, │
15│ identifying the operation, file name, program name, and procedure │
16│ name. The summary report provides a count for each type of file │
17│ operation and the associated report refinement name. The default is │
18│ BOTH. │
19│ │
20│ │
21│ │
22│ │
23│ Cmd3-Exit help text Roll keys-Page help text COPR IBM Corp. 1992│
24│ │
25│ │
26│ │
27│ │
└────────────────────────────────────────────────────────────────────────────────┘
FormPointer36 {name=»TRACE380«, f1=0x00, start=0x0030, length=0x08, f5=0x00, f6=0x00, f7=0x00, f8=0x00, f9=0000000000000000}
┌────────────────────────────────────────────────────────────────────────────────┐
00│ HELP FOR TRACE36 PROCEDURE Page 8 of 9 │
01│ │
02│ ╳Report refinement . . . . . . . . 1STPROC,CURPROC,PROG, │
03│ FNAME,FLABEL,USER,JOB ╳ │
04│ │
05│ Specifies a field by which to further limit report data. Report │
06│ data may be restricted to file operations performed by a specified │
07│ first level procedure, procedure, program, file name, file label, │
08│ user or job. This parameter also affects the summary report as the │
09│ operation counts are summarized by the report refinement field │
10│ specified. The following keywords are allowed for this parameter: │
11│ │
12│ 1STPROC - First level procedure │
13│ CURPROC - Current procedure │
14│ PROG - Program name │
15│ FNAME - File name. Refers to the logical file name. │
16│ FLABEL - File label. Refers to the physical name on the VTOC. │
17│ USER - User ID │
18│ JOB - Job name │
19│ │
20│ The default is 1STPROC (first level procedure). │
21│ │
22│ │
23│ Cmd3-Exit help text Roll keys-Page help text COPR IBM Corp. 1992│
24│ │
25│ │
26│ │
27│ │
└────────────────────────────────────────────────────────────────────────────────┘
FormPointer36 {name=»TRACE390«, f1=0x00, start=0x0038, length=0x07, f5=0x00, f6=0x00, f7=0x00, f8=0x80, f9=0000000000000000}
┌────────────────────────────────────────────────────────────────────────────────┐
00│ HELP FOR TRACE36 PROCEDURE Page 9 of 9 │
01│ │
02│ ╳Report refinement name . . . . . . . . . . . . name,ALL ╳ │
03│ │
04│ Specifies the name used in conjunction with the selected report │
05│ refinement to limit the report. For an unrestricted report, use │
06│ the keyword ALL. The default is ALL. │
07│ │
08│ │
09│ ╳Output device . . . . . . . . . . . . PRINTER,file name ╳ │
10│ │
11│ Defines the destination for the report. If PRINTER is selected, │
12│ the report is routed to the system printer. If a file name is │
13│ provided, the report is written to a disk file of that name via │
14│ the spool. The COPYPRT command is used to make the transfer from │
15│ spool to file, so the output file is in COPYPRT format. The file │
16│ may be viewed or printed using COPYPRT. The default is PRINTER. │
17│ │
18│ │
19│ │
20│ │
21│ │
22│ │
23│ Cmd3-Exit help text Roll keys-Page help text COPR IBM Corp. 1992│
24│ │
25│ │
26│ │
27│ │
└────────────────────────────────────────────────────────────────────────────────┘