SBMJOB’s RQSDTA Parameter
December 11, 2002 Timothy Prickett Morgan
In the “Odds and Ends” column that published in Midrange Guru on November 8, 2002, you wrote about appending an extra character to the end-of-character parameters that are longer than 32 characters in order to pass them through the Submit Job (SBMJOB) command without running into the problem of garbage data replacing trailing blanks. There is another alternative.
The alternative choice is to use the Request Data (RQSDTA) parameter instead of the Command (CMD) parameter.
These two simple example CL programs show the difference:
TstSbmPgm: pgm dcl &cmdstr *char 64 value( 'sndmsg hi MyMsgQ' ) dcl &xgarbage *char 64 value( 'who knows?????? ' ) sbmjob ??rqsdta( 'call TstSndMsg parm(''' *cat &CmdStr + *cat ''' ''' *cat &XGarbage *cat ''')' ) sbmjob ??cmd( call pgm(TstSndMsg) parm(&CmdStr &XGarbage) ) return endpgm
TstSndMsg: pgm ( + &pCmdStr + &pXGarbage + ) dcl &pCmdStr *char 64 dcl &pXGarbage *char 64 dcl &CmdLen *dec ( 15 5 ) value( 64 ) call QCmdExc ( + &pCmdStr + &CmdLen + ) return endpgm
The first runs SBMJOB in two ways: one using RQSDTA and the other using CMD. Both CALLs run the second program, which simply tries to run the content of the first parameter as a command with QCMDEXC. If any garbage shows up at the end of the first parameter, QCMDEXC will cancel. (Note that I use hard-coded message queue MyMsgQ.) In this case, RQSDTA works and CMD fails.
In general, building a command string and using RQSDTA allows you to be precise, while using CMD to build the command string for you allows you to take advantage of the command prompter for formatting. Originally, the CMD parameter wasn’t available; I recall it was added in an early release of OS/400 to help with difficulties such as embedded quotes in character parameters and numeric values.
CMD is so easy to use that RQSDTA has almost been forgotten.
What is it? Why do you need it?
CASS stands for “Coding Accuracy Support System.” This is a test developed by the U.S. Postal Service to determine whether ZIP Code software can accurately assign ZIP Codes to mailing addresses. CASS-certified software is intended to improve the accuracy of carrier route, 5-digit ZIP, ZIP+4, and delivery point codes.
CASS certified means the software has passed the test. When you use CASS software to update and maintain your mailing file, then your mailing file becomes CASS certified. What does this mean to you?
CASS certification is the first step in qualifying for postage discounts. Look at the mail you receive at home and at work; you will see that a lot of it was mailed for less than the regular 37 cent rate.
Despite all the glitz and glamour of the Internet, email, and such, the wheels of America’s economy are lubricated by the ordinary envelope and the U.S. Postal Service.
If your company sends out a lot of mail, there is a good chance CASS certification can cut your postage expense. There are other steps you must perform to get these discounts, but CASS is the first step.
Your mail must be printed, sorted, and then packaged according to postal regulations. It takes some effort, but the potential savings make it worthwhile.
Exactly what happens when you process your mailing files with CASS software? The software breaks the address down into its individual elements: state, city, street name, and so forth. Then the information is compared to the national ZIP+4 database. If a match is found, the ZIP Code, ZIP+4, delivery point, and carrier route are assigned. Also the delivery line is standardized to comply with Postal Service preferences.
If an address can’t be matched, no action is taken. This has the positive effect of allowing you to identify addresses in your mailing files which possibly can’t be delivered, will be delayed in delivery, or at the very minimum need some minor correction to one of the address elements.
Using CASS certified software has many side benefits. You will be able to identify addresses that are potentially undeliverable. It has been estimated that as much as 30% of all advertising mail is never delivered.
That means the costs of postage, printing, paper, and overhead for undelivered mail are wasted. That means if you spend $100,000 on a direct mail campaign, as much as $30,000 could be completely wasted.
CASS software provides a number of intangible benefits. With CASS certification and bar coding there is a good likelihood that that your mail will be delivered sooner. If your invoices are delivered one day sooner, you may receive payment one day sooner.
If you CASS certify your mailing file, you can move on to the next step which is postal automation. This means applying a POSTNET bar code.
POSTNET is that little row of tall and short bars you see on your mail. POSTNET is a special bar code used by the Postal Service to allow automatic sorting machines to work.
It has been reported that bar code standard class (the old third class) mail gets delivered about as soon as first class, instead of the usual 2 or 3 weeks.
The bottom line is that using CASS software will help you keep your customers’ address information in much better shape than they would be otherwise. Your mail may be delivered sooner at less cost and that means more bottom-line dollars for your company.
If you would like more information about CASS and CASS software,
Are FedEx, United Parcel, and Airborne charges
Every bad address can result in a $5 to $10 charge. Even seemingly small addressing errors such as misspelled street names, or missing suite numbers can result in the same penalty as if the address were totally wrong.
Our PER/ZIP4 addressing matching software will match your addresses to the national ZIP+4 postal database. Based on the match PER/ZIP4, will update your addresses to postal standards. Our sophisticated address logic can add missing directionals, correct minor misspellings, and standardize the address format. If PER/ZIP4 can’t match the address, then you know that there is likely a serious error in the address that needs to be corrected.
PER/ZIP4 can be used in a batch mode to update an entire file or interactively to update individual address one at a time. We provide a search function so that you can search the national ZIP+4 database to verify a specific address.
Visit our Web site www.worksright.com for more information and to order a free, no-hassle, 30-day trial. Or call WorksRight Software, Inc., at 601-856-8337.