Using labels

GDDM-PGF V2R1.3 OPS User's Guide

Using labels

GDDM-PGF V2R1.3 OPS User's Guide
SC33-1776-00

You define labels either directly (from the command field) or infile (using a label command).

To define a direct label, enter a single alphabetic character prefixed with a period (.), for example:


          Command ===> .a

A direct label is always associated with the top of the page. Transferring to a direct label redisplays the associated page.

You can redefine the setting of a direct label at any time. The new position overwrites the old.

To define an infile label, have a line begin with a word of from 2 to 10 characters, prefixed with a period (.). For example:


          )ops .L2       ;* The way you define a label.

An infile label must begin with an alphabetic character, and be unique. Duplicate infile labels are considered an error.

To jump to a label, use either LOCATE or GOTO. As you'll see from the examples below, they're very similar, but with some slightly different defaults. Here are some LOCATE examples:


          locate 2          =>  locate page 2 (if the file has pages)
          l p 2             =>  locate page 2
          l l 2             =>  locate line 2
          l .abc            =>  locate label abc (similar to PDF Edit)

Here are some GOTO examples:


          goto 2            =>  goto line 2 (different from Locate 2)
          goto p 2          =>  goto page 2
          goto .abc         =>  goto label abc
          goto abc          =>  goto label abc (not legal with LOCATE)

Note: In order for OPS to locate a label, it must be already known (that is, the flow must have passed the label), or it must be the first command in the record. For example:


          )ops prefix %
          %.a1; box 20 30 4 3               ;* Well defined label
          %box 20 30 2 4 5 ;.a2            ;* NOT well defined

Notices | Terms of use | Support | Contact z/OS