PS (Point-and-Shoot)

The PS tag defines a text string that is to be enabled for point-and-shoot.

Syntax

IMAP options

IMAP group

Parameters

VAR=point-and-shoot-variable-name | %varname

This attribute provides the name of a variable which is to be set when a point-and-shoot phrase is clicked on for selection. You can define this attribute as a variable name preceded by a “%”.

The point-and-shoot-variable-name must follow the standard naming convention described in Rules for variable names.

VALUE=point-and-shoot-value | %varname | *

This attribute provides the value to be placed in the field specified by the VAR attribute. You can define this attribute as a variable name preceded by a “%”. To specify a blank value, the

"'
'"

(quotation mark, apostrophe, blank, apostrophe, quotation mark) coding notation should be used.

When the PS tag is used with the CHOICE tag, VALUE=* can be used to automatically use the current choice number (or SELCHAR value) as the point-and-shoot selection value.

CSRGRP=NO | YES | n

When CSRGRP=YES, the conversion utility generates a cursor group number to be used for this point-and-shoot text field. When CSRGRP=n, the number provided is used for this field.

DEPTH=n | %varname

This attribute defines the depth reserved for the point-and-shoot field. The minimum value is 1 and the maximum value is the remaining panel depth. This attribute is accepted in order to support existing DTL source files that use it. However, although the space is reserved, point-and-shoot does not function in the additional reserved space..

IMAPNAME=image-name | %varname

This attribute is accepted in order to support existing DTL source files that use it. However, it no longer affects the displayed panel.

IMAPNAMEP=image-namep | %varname: This attribute is accepted in order to support existing DTL source files that use it. However, it no longer affects the displayed panel.
PLACE=ABOVE | BELOW | LEFT | RIGHT | %varname: This attribute is accepted in order to support existing DTL source files that use it. However, it no longer affects the displayed panel.

point-and-shoot-text

This is the text of a point-and-shoot entry.

Comments

The PS tag is valid as part of the text following these tags:

INFO TAGS: ATTENTION, CAUTION, DD, DDHD, DT, DTHD, FIG, FIGCAP, H2, H3, H4, LI, LINES, LP, NOTE, NT, P, PD, PT, WARNING, and XMP.
PANEL TAGS: BOTINST, CHOFLD, CHOICE, DTAFLD, DTAFLDD, GRPHDR, LSTCOL, LSTGRP, PNLINST, SELFLD, and TOPINST.

The point-and-shoot-text is color emphasized within the text of the panel. The user places the cursor on the point-and-shoot-text and presses ENTER to select the option.

Restrictions

The PS tag requires an end tag.
When a %varname notation is found on any of the attributes that allow a variable name, the %varname entry must follow the standard naming convention described in Rules for “%variable” names.

Processing

None.

Examples

Here is an example that shows the use of point-and-shoot selection for a sample option menu. Figure 1 shows the formatted result.

<!doctype dm system ()>
<!-- Sample selection menu with point-and-shoot -->
<panel name=ps1 menu keylist=keylxmp>Sample Point-and-Shoot
  <topinst>This is a selection panel.
  <selfld type=menu   pmtloc=before
          selwidth=40 pmtwidth=10>Select an option
    <choice checkvar=xtest1 match=a>
        <PS VAR=zcmd VALUE=1>Selection #1 (Command Tstch1)
</PS>
      <action run=tstch1 parm='1 2 3 4'
       passlib newpool suspend>
    <choice checkvar=xtest1 match=b>
        <PS VAR=zcmd VALUE=2>Selection #2 (Command Tstch2)
</PS>
      <action run=tstch2 parm=1234>
    <choice checkvar=xtest1 match=c>
        <PS VAR=zcmd VALUE=3>Selection #3 (Command Tstch3)
</PS>
      <action run=tstch3 parm=abcd>
    <choice checkvar=xtest1 match=d>
        <PS VAR=zcmd VALUE=4>Selection #4 (Command Tstch4)
</PS>
      <action run=tstch4 parm='a b c d'>
  </selfld>
  <cmdarea>
</panel>

Figure 1. Point-and-shoot fields

                         Sample Point-and-Shoot

 This is a selection panel.

 Select an
 option . . 1  Selection #1 (Command Tstch1)
            2  Selection #2 (Command Tstch2)
            3  Selection #3 (Command Tstch3)
            4  Selection #4 (Command Tstch4)










 Option ===> _____________________________________________________________
  F1=Help        F3=Exit        F5=Display     F6=Keyshelp   F10=Actions
 F12=Cancel