> The only silver lining is continued employment opportunities
LOL... yes, sometimes doc writers can't seem to put themselves in the position of the person reading the doc. They know the details, so why doesn't everyone else?
Non-mainframe example: I recently signed up with zerossl.com for web certificates, and they have API functions that allowed me to write scripts to refresh certs periodically. Really good documentation of each of the dozen or so API functions, but absolutely no example of how to put them all together. Luckily I found an outside blog post literally titled, "ZeroSSL API – The missing examples", which helped a lot. So maybe write a blog page about your experiences for the next person.
On 12/9/2021 5:23 PM, Tom Longfellow wrote:
i am getting older and grumpier ever day. And this is one of the reasons why. z/OS 2.4 introduces change to AT-TLS rules required for the DDS task default setting of https. The example given in the manual for AT-TLS is in the XML cryptospeach of the developers. Since this is too arcane for us old fogeys (and a lot of server pups), IBM provides the GUI (network Communication Assistant) under z/OS to turn the process into pointing and cllicking. What is NOT documented is how to translate the arcane text into which click. So - it is like getting instruction in French for a process that uses English. And the provided translater speaks Urdu. I have spent the last two days attempting to perform my own traslation of both the AT-TLS magical spell and the TCPPARMS from the TCPIP stack. The only silver lining is continued employment opportunities ---------------------------------------------------------------------- For IBM-MAIN subscribe / signoff / archive access instructions, send email to [email protected] with the message: INFO IBM-MAIN .
---------------------------------------------------------------------- For IBM-MAIN subscribe / signoff / archive access instructions, send email to [email protected] with the message: INFO IBM-MAIN
