Format SET VCPU_SAMPLING 3 Description The SET VCPU_SAMPLING Collector command enables the collection of PC values for random vector instructions. The collected data lets you determine the scalar/vector parallelism throughout your entire program. When you collect vector CPU samples, the sampling interval timer includes only the time that the program is actually running the processor. This form of sampling allows you to focus on the particular areas of the program's algorithm where time is being spent, and not on the areas where outside influences consume time. 3 Qualifiers /INTERVAL Specifies the sampling interval in milliseconds. The value of n must be at least 10 milliseconds and at most 60,000 milliseconds. Because the granularity of the system clock is 10 milliseconds, use a multiple of 10. The default sampling interval is 10 milliseconds; therefore, you can use the /INTERVAL:n qualifier only to specify a longer sampling interval. /STACK_PCS Specifies that stack PC values for vector CPU data are to be collected. The /STACK_PCS qualifier is the default upon entry into the Collector. /NOSTACK_PCS Specifies that not stack PC values for vector CPU data are to be collected. If used, /NOSTACK_PCS causes further SET VCPU_SAMPLING requests to assume a default of /NOSTACK_PCS. 3 Examples PCAC> SET VCPU_SAMPLING/INTERVAL:20/NOSTACK_PCS This command causes the interval to be 20 milliseconds, and disables STACK_PCS collection for this measurement. For all further SET VCPU_SAMPLING requests, a default of /NOSTACK_PCS will be assumed. 2 VERIFY PCA Command Causes PCA to verify command input by echoing it to the terminal. Format SET VERIFY 3 Description The SET VERIFY command causes PCA to echo subsequent command input to the terminal. Input verification is useful when you want to see the commands from command procedures as they are executed. You can disable input verification with the CANCEL VERIFY command. 3 Examples PCAC> SET VERIFY PCAC> @X.COM @X.COM SET DATAFILE [SAGER.TST]PCAPRIME SET LANGUAGE C PCAC> The SET VERIFY command enables input verification. The next command entered (@X.COM) is therefore echoed to the terminal. Then a SET DATAFILE and a SET LANGUAGE command are read from the command procedure X.COM. Both commands are echoed to the terminal. 2 VPC_SAMPLING Collector Command Enables the collection of vector program counter sampling data. Format SET VPC_SAMPLING 3 Description The SET VPC_SAMPLING Collector command enables the collection of PC values for random vector instructions and causes the sampling rate to be applied to the wall clock. The collected data lets you determine the scalar/vector parallelism throughout your entire program. When you collect vector PC samples, the sampling interval timer includes all idle time associated with the current run of the program. This form of sampling shows you where the time is being spent in the program with little cost to the time of actually running the program. time. You can set the time interval by using the /INTERVAL qualifier. 3 Qualifiers /INTERVAL /INTERVAL:n Specifies the sampling interval in milliseconds. The value of n must be at the least 10 milliseconds and at the most 60,000 milliseconds. Because the granularity of the system clock is 10 milliseconds, use a multiple of 10. The default sampling interval is 10 milliseconds; therefore, you can use the /INTERVAL:n qualifier only to specify a longer sampling interval. /STACK_PCS Specifies that stack PC values for vector PC data are to be collected. The /STACK_PCS qualifier is the default upon entry into the Collector. /NOSTACK_PCS Specifies that stack PC values for vector PC data are not to be collected. If you specify /NOSTACK_PCS, further SET VPC_SAMPLING requests assume a default of /NOSTACK_PCS. 3 Examples PCAC> SET VPC_SAMPLING/INTERVAL:20/NOSTACK_PCS This command causes the interval to be 20 milliseconds, and disables STACK_PCS collection for this measurement. For all further SET VPC_SAMPLING requests, a default of /NOSTACK_PCS will be assumed. 2 WINDOW PCA Command Defines screen window names. Format SET WINDOW window-name AT (start-line,line-count,start-column,column-count) 3 Parameters window-name Specifies the name of the window to define. The window name must consist of letters, digits, underscores, and dollar signs. It cannot begin with a digit. start-line Specifies the starting line number of the window. This line displays the top header line for the screen display using the window. The top line of the screen is line number 1. line-count Specifies the number of text lines in the window. start-column Specifies the starting (leftmost) column number of the window (the default is column 1). column-count Specifies the number of columns in the window (the default is the current screen width). 3 Description The SET WINDOW command allows you to assign a name to a screen window. A screen window is a region on the terminal screen through which you can view a display. You must specify the window in terms of a starting line number on the screen and a line count. Once defined, a window name can be used in subsequent DISPLAY and SET DISPLAY commands. PCA provides a substantial number of predefined window names. You can list all defined window names using the SHOW WINDOW command. 3 Examples PCAA> SET WINDOW TINY AT (1,2) PCAA> DISPLAY OUT AT TINY The first command defines a window named TINY. The top border line for the window is at line 1 of the terminal screen. The window can display two additional lines of text. The second command displays the OUT screen display through window TINY.