Making amendments to SARPJ Panel to include text that contains attribute characters OM View

Products

• Deliver
• View
• Output Management Web Viewer

Issue/Introduction

A technical team has requested a change to the sample job in panel SARPJ. Within this job card they would like the following added:

  SCHENV='JOBS_DEV_BATCH' 

As the underscore is an attribute character how can I include this?

Environment

• View®
• Deliver™
• Output Management Web Viewer™
• OM View for z
• Output Management View® for z/OS
• Output Management Deliver™ for z/OS

Resolution

The SARPJ panel as delivered contains neither )ATTR nor )BODY statements. As per ISPF rules (see ISPF dialog developer's guide and reference) this means that the ISPF default attribute characters are in effect for it, which are:

     
     % (percent sign) - Protected high-intensity text                                 
     +  (plus sign)     - protected low-intensity text                                     
     _  (underscore)   - unprotected (input) high-intensity text     
  

If you place an _ (underscore) anywhere in the )BODY section (for SARPJ panel this means anywhere from first line to the )INIT line), ISPF will interpret it as the beginning of an input field and will NOT display whatever is beyond the underscore. Your ONLY option is to change the default attribute characters for that particular panel. As per the ISPF guide, they must not conflict with whatever is displayed in the panel body.

Example SARPJ panel changes:

 

 )ATTR DEFAULT(%+@)                                                      
 )BODY                                                                   
 %&PRD &MOD ----------------- BATCH JOB JCL -----------------------------
 %COMMAND ===>@OPT                                             +         
                                                                         
                                                                         
 +JOB STATEMENT INFORMATION:                                             
 %  ===>@SJC1                                                            
 %  ===>@SJC2                                                            
 %  ===>@SJC3                                                            
 %  ===>@SJC4                                                            
 +                                                                       
 +        this is a text line                                            
 +    this line contains an underscore _ and more text                   
 )INIT                                                                   
   .HELP = SARPTJ                                                        
 )END     
 

Description of SARPJ panel changes:

1. Add an )ATTR section (line 1) changing the default attribute characters for this panel to '%+@' (percent sign, plus sign and AT sign).
2. Add a )BODY statement to mark the end of the attribute section and the beginning of the panel body.
3. For each and every input field (the command and the four jobcard lines) you replace the old input field mark _ (the underscore) with the new input field mark @ (the AT sign).
4. Then you are free to place an _ (underscore) wherever you need it displayed in the panel body.